This documentation is archived and is not being maintained.

ValueTypePropertyReference<TOperand, TResult> Class

Represents a property on a value type that can be used as an l-value in an expression.

System::Object
  System.Activities::Activity
    System.Activities::ActivityWithResult
      System.Activities::Activity<Location<TResult>>
        System.Activities::CodeActivity<Location<TResult>>
          System.Activities.Expressions::ValueTypePropertyReference<TOperand, TResult>

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

generic<typename TOperand, typename TResult>
public ref class ValueTypePropertyReference sealed : public CodeActivity<Location<TResult>^>

Type Parameters

TOperand

The value type.

TResult

The property type.

The ValueTypePropertyReference<TOperand, TResult> type exposes the following members.

  NameDescription
Public methodValueTypePropertyReference<TOperand, TResult>Initializes a new instance of the ValueTypePropertyReference<TOperand, TResult> class.
Top

  NameDescription
Protected propertyCacheIdGets the identifier of the cache that is unique within the scope of the workflow definition. (Inherited from Activity.)
Protected propertyConstraintsGets a collection of Constraint activities that can be configured to provide validation for the Activity. (Inherited from Activity.)
Public propertyDisplayNameGets or sets an optional friendly name that is used for debugging, validation, exception handling, and tracking. (Inherited from Activity.)
Public propertyIdGets an identifier that is unique in the scope of the workflow definition. (Inherited from Activity.)
Protected propertyImplementationNot supported. (Inherited from CodeActivity<TResult>.)
Public propertyOperandLocationGets or sets the instance of the value type that contains the property.
Public propertyPropertyNameGets or sets the name of the property.
Public propertyResultGets or sets the result argument for the Activity<TResult>. (Inherited from Activity<TResult>.)
Public propertyResultTypeWhen implemented in a derived class, gets the type of an activity OutArgument. (Inherited from ActivityWithResult.)
Top

  NameDescription
Protected methodCacheMetadata(ActivityMetadata)Not implemented. Use CacheMetadata(CodeActivityMetadata) instead. (Inherited from CodeActivity<TResult>.)
Protected methodCacheMetadata(CodeActivityMetadata)Creates and validates a description of the activity’s arguments, variables, child activities, and activity delegates. (Inherited from CodeActivity<TResult>.)
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodExecuteWhen implemented in a derived class, performs the execution of the activity. (Inherited from CodeActivity<TResult>.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodShouldSerializeDisplayNameIndicates whether the DisplayName property should be serialized. (Inherited from Activity.)
Public methodToStringReturns a String that contains the Id and DisplayName of the Activity. (Inherited from Activity.)
Top

The following code example uses ValueTypePropertyReference<TOperand, TResult> in an Assign activity to assign a string value to a property and prints the property value to the console. The Assign activity is equivalent to the following statement when using the struct defined in the following example: myStructVariable.AProperty = "Hello";.

NoteNote

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


    // Define a struct with a property named AProperty.
    struct StructWithProperty
    {
        public string AProperty { get; set; }
    }

    public static void ValueTypePropertyReferenceSample()
    {
        // Create a variable of type StructWithProperty to store the property.
        var swpvar = new Variable<StructWithProperty>("swpvar", new StructWithProperty());

        // Create the top-level activity to be invoked later.
        Activity myActivity = new Sequence
        {
            Variables = { swpvar },
            Activities = 
            {                    
                // Create an Assign activity for a property named AProperty.
                new Assign<string>
                {
                    To = new ValueTypePropertyReference<StructWithProperty, string>
                    {
                        OperandLocation = swpvar,
                        PropertyName = "AProperty",
                    },
                    // Assign a string literal to AProperty.
                    Value = "Hello",
                },
                // Create a WriteLine activity to write the value of AProperty to the console.
                new WriteLine()
                {
                    Text = ExpressionServices.Convert<string>(ctx => swpvar.Get(ctx).AProperty),
                }
            }
        };

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

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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