ActivityTrackPoint.MatchingLocations Property

Definition

Namespace:

System.Workflow.Runtime.Tracking

Assembly:

System.Workflow.Runtime.dll

Gets the collection of locations that should be included in matching for the track point by the runtime tracking infrastructure.

public:
 property System::Workflow::Runtime::Tracking::ActivityTrackingLocationCollection ^ MatchingLocations { System::Workflow::Runtime::Tracking::ActivityTrackingLocationCollection ^ get(); };

public System.Workflow.Runtime.Tracking.ActivityTrackingLocationCollection MatchingLocations { get; }

member this.MatchingLocations : System.Workflow.Runtime.Tracking.ActivityTrackingLocationCollection

Public ReadOnly Property MatchingLocations As ActivityTrackingLocationCollection

Property Value

ActivityTrackingLocationCollection

An ActivityTrackingLocationCollection that specifies the locations to be matched for the track point. The default is an empty collection.

Examples

The following example demonstrates accessing the MatchingLocations property. This example is from the TrackingProfileDesigner SDK sample. For more information, see Tracking Profile Designer Sample.

/// <summary>
/// Saves a tracking condition for an activity
/// </summary>
/// <param name="activity"></param>
/// <param name="key"></param>
/// <param name="member"></param>
/// <param name="op"></param>
/// <param name="value"></param>
internal void SaveTrackingCondition(Activity activity, ref ActivityTrackingCondition key, string member, ComparisonOperator op, string value)
{
    ActivityTrackPoint trackPoint = GetTrackPointForActivity(activity);
    if (trackPoint != null)
    {
        if (key == null)
        {
            key = new ActivityTrackingCondition();
            trackPoint.MatchingLocations[0].Conditions.Add(key);
        }
        key.Member = member;
        key.Value = value;
        key.Operator = op;
    }
}

' Saves a tracking condition for an activity
' <param name="activity"></param>
' <param name="key"></param>
' <param name="member"></param>
' <param name="op"></param>
' <param name="value"></param>
Friend Sub SaveTrackingCondition(ByVal activity As Activity, ByRef key As ActivityTrackingCondition, ByVal member As String, ByVal op As ComparisonOperator, ByVal value As String)
    Dim trackPoint As ActivityTrackPoint = GetTrackPointForActivity(activity)
    If trackPoint IsNot Nothing Then
        If (key Is Nothing) Then
            key = New ActivityTrackingCondition()
            trackPoint.MatchingLocations(0).Conditions.Add(key)
        End If
        key.Member = member
        key.Value = value
        key.Operator = op
    End If
End Sub

Remarks

If MatchingLocations is empty, the track point cannot be matched by the runtime tracking infrastructure. You must add at least one ActivityTrackingLocation to MatchingLocations for the ActivityTrackPoint to participate in matching.

The track point will be matched if any ActivityTrackingLocation in MatchingLocations is matched by the runtime tracking infrastructure and no ActivityTrackingLocation in ExcludedLocations is matched.