Represents a name and value pair used to correlate messages to specific receiving activities.
System.Workflow.Runtime.CorrelationProperty
Namespace: System.Workflow.Runtime
Assembly: System.Workflow.Runtime (in System.Workflow.Runtime.dll)
<SerializableAttribute> _ Public Class CorrelationProperty
[SerializableAttribute] public class CorrelationProperty
[SerializableAttribute] public ref class CorrelationProperty
[<SerializableAttribute>] type CorrelationProperty = class end
The CorrelationProperty type exposes the following members.
| Name | Description | |
|---|---|---|
|
CorrelationProperty | Initializes a new instance of the CorrelationProperty class. |
| Name | Description | |
|---|---|---|
|
Name | Gets the name of the property used in the correlation set. |
|
|
Value | Gets the value of the correlation set property. |
| Name | Description | |
|---|---|---|
|
|
Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
|
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
|
|
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
|
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
|
ToString | Returns a string that represents the current object. (Inherited from Object.) |
CorrelationProperty classes are defined as ActivityBind properties of Workflow Connection Service activities. By default, these properties are bound to variables declared at the root workflow activity. For dynamic activities such as ReplicatorActivity and ConditionedActivityGroup each of its children cannot share a universal CorrelationProperty object. Consider the scenario where each task inside a ReplicatorActivity has to manage its own conversation. The child activities inside the ReplicatorActivity requires a CorrelationProperty instance unique per execution context, or per task. In order to accomplish this, you have to define a custom activity that has a CorrelationProperty instance property and the Workflow Connection Services activities have to bind to this property.
The following example demonstrates creating a correlation property object, and accessing the Name and Value properties.
' Create a new Correlation Property object Dim correlationProperty As New CorrelationProperty("taskName", "reportBalance") ' Read the property name Dim taskName As String = correlationProperty.Name ' Read the property value Dim taskValue As Object = correlationProperty.Value
// Create a new Correlation Property object CorrelationProperty correlationProperty = new CorrelationProperty("taskName", "reportBalance"); // Read the property name String taskName = correlationProperty.Name; // Read the property value Object taskValue = correlationProperty.Value;
.NET Framework
Supported in: 4, 3.5, 3.0Windows 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.