UserTrackPoint UserTrackPoint UserTrackPoint UserTrackPoint Class

定義

警告

此 API 現已淘汰。

為根活動流程執行個體潛在執行路徑上要追蹤的使用者事件定義一個關聯的點。Defines a point, associated with a user event, to be tracked in the potential execution path of a root workflow instance. 此類別無法被繼承。This class cannot be inherited.

public ref class UserTrackPoint sealed
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public sealed class UserTrackPoint
type UserTrackPoint = class
Public NotInheritable Class UserTrackPoint
繼承
UserTrackPointUserTrackPointUserTrackPointUserTrackPoint
屬性

備註

注意

此資料討論已被汰換的類型及命名空間。This material discusses types and namespaces that are obsolete. 如需詳細資訊,請參閱 Windows Workflow Foundation 4.5 中即將淘汰的類型For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

活動設計工具或工作流程設計工具可使用多載的 Activity.TrackDataActivityExecutionContext.TrackData 方法,以指示工作流程發出資料到執行階段追蹤基礎結構做為使用者事件。An activity designer or a workflow designer may use the overloaded Activity.TrackData and ActivityExecutionContext.TrackData methods to instrument the workflow to emit data to the runtime tracking infrastructure as a user event. 發出的資料稱為使用者資料。The data emitted is referred to as user data. 與活動狀態事件不同的是,工作流程狀態事件只發生在狀態變更時,使用者事件可能發生在工作流程中指示的任何位置。Unlike activity status events, and workflow status events, which occur only on status changes, user events can occur at any location that is instrumented in a workflow. 指示工作流程發出使用者事件有很多原因。There are many reasons to instrument a workflow to emit user events. 例如,工作流程設計工具可能想要傳達有關工作流程進度的邏輯狀態資訊,或活動設計工具可能想要在活動狀態變更以外的時候提供機會給活動成員。For example, a workflow designer may want to communicate logical state information about the progress of a workflow, or an activity designer might want to provide an opportunity to activity members at times other than an activity status change.

UserTrackPoint 定義根活動流程執行個體潛在執行路徑中與使用者事件關聯的點。A UserTrackPoint defines a point of interest in the potential execution path of a root workflow instance associated with a user event. UserTrackPoint 包含加入比對中的位置、排除在比對外的位置,以及要在追蹤點符合時從工作流程執行個體中擷取的任何其他資料。A UserTrackPoint contains locations that are included in matching, locations that are excluded from matching, and any additional data that should be extracted from the workflow instance when the track point is matched. 您可以將 UserTrackPoint 加入至 TrackingProfile.UserTrackPoints,以指示執行階段追蹤基礎結構在追蹤點符合時傳送 UserTrackingRecord 至追蹤服務。You can add a UserTrackPoint to TrackingProfile.UserTrackPoints to instruct the runtime tracking infrastructure to send a UserTrackingRecord to the tracking service when the track point is matched. 使用者資料會在 UserTrackingRecord.UserData 中傳回。The user data is returned in UserTrackingRecord.UserData. 一個 UserTrackPoint 可能會符合工作流程執行個體中的多個點。A single UserTrackPoint may be matched at multiple points in the workflow instance.

UserTrackingLocation 包含與工作流程執行個體潛在執行路徑中的使用者事件關聯的位置比對條件。A UserTrackingLocation contains match conditions for a location associated with a user event in the potential execution path of a workflow instance. 您可以將 UserTrackingLocation 物件加入至 MatchingLocations 中,以定義要包含在追蹤點比對中的位置。You can add UserTrackingLocation objects to MatchingLocations to define locations that should be included in matching for the track point. 同樣地,您可以將 UserTrackingLocation 物件新增至 ExcludedLocations 中,以定義要排除在追蹤點比對外的位置。Similarly, you can add UserTrackingLocation objects to ExcludedLocations to define locations that should be excluded from matching for the track point.

您可以將 ActivityDataTrackingExtract 物件和 WorkflowDataTrackingExtract 物件加入至 Extracts 中,以指定在追蹤點符合時要從工作流程執行個體中擷取的資料。You can add ActivityDataTrackingExtract objects and WorkflowDataTrackingExtract objects to Extracts to specify data that should be extracted from the workflow instance when the track point is matched. 擷取的資料將在 UserTrackingRecord.Body 中傳回。The extracted data will be returned in UserTrackingRecord.Body.

您可以加入 Annotations,以指定與追蹤點關聯的其他資訊。You can add to Annotations to specify additional information associated with the track point. 這些附註將在 UserTrackPoint.Annotations 中傳回。These annotations will be returned in UserTrackPoint.Annotations.

如需如何使用這個類別的範例,請參閱 < 追蹤使用使用者追蹤點範例For an example of how to use this class, see the Tracking Using User Track Points Sample.

建構函式

UserTrackPoint() UserTrackPoint() UserTrackPoint() UserTrackPoint()

初始化 UserTrackPoint 類別的新執行個體。Initializes a new instance of the UserTrackPoint class.

屬性

Annotations Annotations Annotations Annotations

取得與追蹤點關聯之附註的集合。Gets the collection of annotations associated with the track point.

ExcludedLocations ExcludedLocations ExcludedLocations ExcludedLocations

取得應由執行階段追蹤基礎結構排除在追蹤點外的位置集合。Gets the collection of locations that should be excluded from the track point by the runtime tracking infrastructure.

Extracts Extracts Extracts Extracts

取得集合,該集合指定要從工作流程執行個體擷取並傳送至追蹤服務的資料。Gets a collection that specifies data to be extracted from the workflow instance and sent to the tracking service.

MatchingLocations MatchingLocations MatchingLocations MatchingLocations

取得應由執行階段追蹤基礎結構包含在追蹤點比對內的位置集合。Gets the collection of locations that should be included in matching for the track point by the runtime tracking infrastructure.

方法

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(Inherited from Object)

適用於