ActivityTrackingLocation Class

Reference

Definition

Namespace:: System.Workflow.Runtime.Tracking

Assembly:: System.Workflow.Runtime.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Caution

The System.Workflow.* types are deprecated. Instead, please use the new types from System.Activities.*

Defines an activity-qualified location that corresponds to an activity status event in the potential execution path of a root workflow instance. This class cannot be inherited.

public ref class ActivityTrackingLocation sealed

[System.Serializable]
public sealed class ActivityTrackingLocation

[System.Serializable]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public sealed class ActivityTrackingLocation

[<System.Serializable>]
type ActivityTrackingLocation = class

[<System.Serializable>]
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type ActivityTrackingLocation = class

Public NotInheritable Class ActivityTrackingLocation

Inheritance: Object
ActivityTrackingLocation

Attributes: SerializableAttribute ObsoleteAttribute

Remarks

Note

This material discusses types and namespaces that are obsolete. For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

Whenever the execution status of an activity changes, the workflow instance emits an activity status event to the runtime tracking infrastructure. The runtime tracking infrastructure can send the tracking service an ActivityTrackingRecord whenever an activity status event occurs. Usually, a tracking service is not interested in every activity status event that occurs in the workflow instance, but only in activity status events associated with certain kinds of activities at specified locations in the workflow instance. An ActivityTrackingLocation defines the matching parameters for such a location by specifying a reference activity type, a set of activity status change events, and a set of conditions that can more precisely qualify an instance or instances of the reference activity type.

Note

A single ActivityTrackingLocation may refer to more than one actual location in the potential execution path of a workflow instance.

You add ActivityTrackingLocation objects to MatchingLocations and ExcludedLocations in order to define the match parameters for an ActivityTrackPoint in a TrackingProfile.

You must specify the reference activity type to be matched by setting either ActivityTypeName or ActivityType.

You may set MatchDerivedTypes to specify interest in activities derived from the reference activity type.

You may add ActivityExecutionStatus values to ExecutionStatusEvents to specify the activity status events to be matched.

You may add ActivityTrackingCondition objects to Conditions to specify interest in the reference activity type only for specific conditions. For example, you can specify interest in only a particular named instance of the reference activity type.

Constructors

ActivityTrackingLocation()	Initializes a new instance of the ActivityTrackingLocation class.
ActivityTrackingLocation(String)	Initializes a new instance of the ActivityTrackingLocation class by using the specified activity name.
ActivityTrackingLocation(String, Boolean, IEnumerable<ActivityExecutionStatus>)	Initializes a new instance of the ActivityTrackingLocation class that has a reference activity type with the specified unqualified name, that specifies whether to match activities derived from the reference activity type, and that matches the specified activity execution status events.
ActivityTrackingLocation(String, IEnumerable<ActivityExecutionStatus>)	Initializes a new instance of the ActivityTrackingLocation class that has a reference activity type with the specified unqualified name and that matches the specified activity execution status events.
ActivityTrackingLocation(Type)	Initializes a new instance of the ActivityTrackingLocation class by using the specified reference activity type.
ActivityTrackingLocation(Type, Boolean, IEnumerable<ActivityExecutionStatus>)	Initializes a new instance of the ActivityTrackingLocation class that has the specified reference activity type, that specifies whether to match activities derived from the reference activity type, and that matches the specified activity execution status events.
ActivityTrackingLocation(Type, IEnumerable<ActivityExecutionStatus>)	Initializes a new instance of the ActivityTrackingLocation class that has the specified reference activity type and matches the specified activity execution status events.

Properties

ActivityType	Gets or sets the common language runtime (CLR) type of the reference activity to be matched.
ActivityTypeName	Gets or sets the unqualified name of the reference activity type for the location.
Conditions	Gets a collection of conditions that are used to qualify interest in the activity.
ExecutionStatusEvents	Gets the list of activity status events that can be matched for this location.
MatchDerivedTypes	Gets or sets a value that indicates whether activities derived from the reference activity type should be matched.

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (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)

Applies to