MultidimensionalArrayItemReference<TItem> Class

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Represents an element in a multidimensional array that can be used as an l-value in an expression.

Namespace:   System.Activities.Expressions
Assembly:  System.Activities (in System.Activities.dll)

System.Object
  System.Activities.Activity
    System.Activities.ActivityWithResult
      System.Activities.Activity<TResult>
        System.Activities.CodeActivity<TResult>
          System.Activities.Expressions.MultidimensionalArrayItemReference<TItem>

[ContentPropertyAttribute("Indices")]
public sealed class MultidimensionalArrayItemReference<TItem> : CodeActivity<Location<TItem>>

Type Parameters

TItem

The type of elements in the array.

NameDescription
System_CAPS_pubmethodMultidimensionalArrayItemReference<TItem>()

Initializes a new instance of the MultidimensionalArrayItemReference<TItem> class.

NameDescription
System_CAPS_pubpropertyArray

Gets or sets the array referenced by the MultidimensionalArrayItemReference<TItem>.

System_CAPS_protpropertyCacheId

Gets the identifier of the cache that is unique within the scope of the workflow definition.(Inherited from Activity.)

System_CAPS_pubpropertyDisplayName

Gets or sets an optional friendly name that is used for debugging, validation, exception handling, and tracking.(Inherited from Activity.)

System_CAPS_pubpropertyId

Gets an identifier that is unique in the scope of the workflow definition.(Inherited from Activity.)

System_CAPS_protpropertyImplementationVersion

Gets or sets the implementation version of the activity.(Inherited from CodeActivity<TResult>.)

System_CAPS_pubpropertyIndices

Gets a collection of arguments that represent the indices of the element in the array.

System_CAPS_pubpropertyResult

Gets or sets the result argument for the Activity<TResult>.(Inherited from Activity<TResult>.)

System_CAPS_pubpropertyResultType

When implemented in a derived class, gets the type of an activity OutArgument.(Inherited from ActivityWithResult.)

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodShouldSerializeDisplayName()

Indicates whether the DisplayName property should be serialized.(Inherited from Activity.)

System_CAPS_pubmethodToString()

Returns a String that contains the Id and DisplayName of the Activity.(Inherited from Activity.)

The following code example uses MultidimensionalArrayItemReference<TItem> in an Assign activity to assign an integer value to the array element at row 1 and column 2 and prints the value of the array element to the console. The Assign activity is equivalent to the following statement when using arrays: array[1, 2] = 1;.

System_CAPS_noteNote

Instead of instantiating the MultidimensionalArrayItemReference<TItem> l-value expression activity directly, it is strongly recommended that you call ConvertReference<TResult>, which provides a higher level of abstraction and enables you to implement your workflow more intuitively.


public static void MultidimensionalArrayItemReferenceSample()
{
    // Create a variable to store a multidimensional array.
    var arrayvar = new Variable<int[,]>("arrayvar", new int[4, 5]);

    Activity myActivity = new Sequence
    {
        Variables = { arrayvar },
        Activities = 
        {                    
            // Create an Assign activity to assign a value to the array item at index [1,2].
            new Assign<int>
            {
                To = new MultidimensionalArrayItemReference<int>
                {
                    Array = arrayvar,
                    Indices = {1, 2}
                },
                // Assign an integer value to the array item at row 1 column 2.
                Value = 1,
            },
            // Print the array item value to the console.
            new WriteLine()
            {
                Text = ExpressionServices.Convert<string>(ctx => arrayvar.Get(ctx)[1, 2].ToString()),
            }
        }
    };

    // Invoke the Sequence activity.
    WorkflowInvoker.Invoke(myActivity);
}

.NET Framework
Available since 4.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: