UserTrackingLocation UserTrackingLocation UserTrackingLocation UserTrackingLocation Class

定義

警告

此 API 現已淘汰。

定義對應根工作流程執行個體潛在執行路徑中的使用者事件的活動限定位置。Defines an activity-qualified location that corresponds to a user event in the potential execution path of a root workflow instance. 這個類別無法被繼承。This class cannot be inherited.

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

備註

注意

此資料討論已被汰換的類型及命名空間。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 any of 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 activity or workflow status changes, user events can occur at any location that is instrumented in a workflow. UserTrackingLocation 會指定使用者資料類型、必須發出資料的活動類型、可更精確地限定此活動之執行個體的條件集合、使用者資料必須與其產生關聯的索引鍵名稱 (選擇性)、是否應比對使用者資料的衍生類型,以及是否應比對衍生自指定活動類型之活動上發出的使用者資料,藉此定義這類位置的比對參數。A UserTrackingLocation defines the matching parameters for such a location by specifying the type of the user data, the type of the activity from which it must be emitted, a collection of conditions that can more precisely qualify an instance or instances of this activity, an optional key name with which the user data must be associated, whether derived types of the user data should be matched, and whether user data emitted from activities derived from the type of the specified activity should be matched.

注意

單一 UserTrackingLocation 可能會參考工作流程執行個體潛在執行路徑中的多個實際位置。A single UserTrackingLocation may refer to more than one actual location in the potential execution path of a workflow instance.

您可以將 UserTrackingLocation 加入至 UserTrackPoint.MatchingLocationsUserTrackPoint.ExcludedLocations 中,以定義 UserTrackPointTrackingProfile 的比對參數。You may add a UserTrackingLocation to either UserTrackPoint.MatchingLocations or UserTrackPoint.ExcludedLocations in order to define the match parameters for a UserTrackPoint in a TrackingProfile.

執行階段追蹤基礎結構比對 UserTrackingLocation 必須依下列順序符合三個一般條件:發出使用者事件的活動必須符合 ActivityTypeActivityTypeNameConditionsMatchDerivedActivityTypes 指定的活動集合;如果存在與使用者資料關聯的索引鍵,則這個索引鍵必須符合 KeyName;使用者事件發出的使用者資料型別必須符合 ArgumentTypeArgumentTypeNameMatchDerivedArgumentTypes 指定的使用者資料型別集合。There are three general conditions which must be met in the following order for the UserTrackingLocation to be matched by the runtime tracking infrastructure: the activity that has emitted a user event must match the set of activities specified by ActivityType, ActivityTypeName, Conditions, and MatchDerivedActivityTypes; the key, if one exists, associated with the user data must match KeyName; and, the type of the user data emitted by the user event must match the set of user data types specified by ArgumentType, ArgumentTypeName, and MatchDerivedArgumentTypes. 只有這三個條件全都符合時,執行階段追蹤基礎結構才會將 UserTrackingLocation 視為符合。Only if all three of these conditions are met, does the runtime tracking infrastructure consider the UserTrackingLocation matched.

若要設定 UserTrackingLocation,您必須將 ArgumentTypeNameArgumentType 設為指定要比對的使用者資料型別,並且將 ActivityTypeNameActivityType 設為指定要比對且必須發出使用者資料的來源活動型別。To configure a UserTrackingLocation, you must set either ArgumentTypeName or ArgumentType to specify the type of the user data to be matched and either ActivityTypeName or ActivityType to specify the type of the activity from which the user data must be emitted to be matched. 您可以將 ActivityTrackingCondition 物件加入至 Conditions 中,以便更完整地限定發出使用者資料的來源活動。You may add ActivityTrackingCondition objects to Conditions to more completely qualify the activity from which the user data must be emitted. 您可以將 MatchDerivedArgumentTypes 設為指定應比對衍生自 ArgumentTypeNameArgumentType 指定之使用者資料型別的使用者資料,也可以將 MatchDerivedActivityTypes 設為指定應比對衍生自 ActivityTypeNameActivityType 指定之活動型別的活動所發出的使用者資料。You may set MatchDerivedArgumentTypes to specify that user data derived from the user data type specified by ArgumentTypeName or ArgumentType should be matched, and you may set MatchDerivedActivityTypes to specify that user data emitted from activities derived from the activity type specified by ActivityTypeName or ActivityType should be matched.

您可以將 KeyName 設為指定只針對此 UserTrackingLocation 比對與指定之索引鍵名稱關聯的使用者資料。You may set KeyName to specify that only user data associated with the specified key name should be matched for this UserTrackingLocation. 如果 KeyName 是 null 參考 (在 Visual Basic 中為 Nothing),執行階段追蹤結構將不會試著比對與使用者資料關聯的索引鍵。If KeyName is a null reference (Nothing in Visual Basic), the runtime tracking structure will not try to match the key associated with the user data.

建構函式

UserTrackingLocation() UserTrackingLocation() UserTrackingLocation() UserTrackingLocation()

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

UserTrackingLocation(String) UserTrackingLocation(String) UserTrackingLocation(String) UserTrackingLocation(String)

使用使用者資料之 Common Language Runtime (CLR) 型別的非限定名稱,初始化 UserTrackingLocation 類別的新執行個體。Initializes a new instance of the UserTrackingLocation class by using the unqualified name of the common language runtime (CLR) type of the user data.

UserTrackingLocation(String, String) UserTrackingLocation(String, String) UserTrackingLocation(String, String) UserTrackingLocation(String, String)

使用使用者資料之 Common Language Runtime (CLR) 型別的非限定名稱,以及必須發出使用者資料之來源活動的 CLR 型別非限定名稱,初始化 UserTrackingLocation 類別的新執行個體。Initializes a new instance of the UserTrackingLocation class by using the unqualified name of the common language runtime (CLR) type of the user data and the unqualified name of the CLR type of the activity from which the user data must be emitted.

UserTrackingLocation(String, Type) UserTrackingLocation(String, Type) UserTrackingLocation(String, Type) UserTrackingLocation(String, Type)

使用使用者資料之 Common Language Runtime (CLR) 型別的非限定名稱,以及發出使用者資料之來源活動的 CLR 型別,初始化 UserTrackingLocation 類別的新執行個體。Initializes a new instance of the UserTrackingLocation class by using the unqualified name of the common language runtime (CLR) type of the user data and the CLR type of the activity from which the user data must be emitted.

UserTrackingLocation(Type) UserTrackingLocation(Type) UserTrackingLocation(Type) UserTrackingLocation(Type)

使用使用者資料的 Common Language Runtime (CLR) 型別,初始化 UserTrackingLocation 類別的新執行個體。Initializes a new instance of the UserTrackingLocation class using the common language runtime (CLR) type of the user data.

UserTrackingLocation(Type, String) UserTrackingLocation(Type, String) UserTrackingLocation(Type, String) UserTrackingLocation(Type, String)

使用使用者資料的 Common Language Runtime (CLR) 型別,以及必須發出使用者資料之來源活動的 CLR 型別非限定名稱,初始化 UserTrackingLocation 類別的新執行個體。Initializes a new instance of the UserTrackingLocation class by using the common language runtime (CLR) type of the user data and unqualified name of the CLR type of the activity from which the user data must be emitted.

UserTrackingLocation(Type, Type) UserTrackingLocation(Type, Type) UserTrackingLocation(Type, Type) UserTrackingLocation(Type, Type)

使用使用者資料的 Common Language Runtime (CLR) 型別,以及必須發出使用者資料之來源活動的 CLR 型別,初始化 UserTrackingLocation 類別的新執行個體。Initializes a new instance of the UserTrackingLocation class by using the common language runtime (CLR) type of the user data and the CLR type of the activity from which the user data must be emitted.

屬性

ActivityType ActivityType ActivityType ActivityType

取得或設定活動的 Common Language Runtime (CLR) 型別,這個活動是要追蹤且必須發出使用者資料的來源活動。Gets or sets the common language runtime (CLR) type of the activity from which the user data must be emitted to be tracked.

ActivityTypeName ActivityTypeName ActivityTypeName ActivityTypeName

取得或設定活動之 Common Language Runtime (CLR) 型別的非限定名稱,這個活動是要追蹤且必須發出使用者資料的來源活動。Gets or sets the unqualified name of the common language runtime (CLR) type of the activity from which the user data must be emitted to be tracked.

ArgumentType ArgumentType ArgumentType ArgumentType

取得或設定要追蹤之使用者資料的 Common Language Runtime (CLR) 型別。Gets or sets the common language runtime (CLR) type of the user data to be tracked.

ArgumentTypeName ArgumentTypeName ArgumentTypeName ArgumentTypeName

取得或設定要追蹤之使用者資料的 Common Language Runtime (CLR) 型別非限定名稱。Gets or sets the unqualified name of the common language runtime (CLR) type of the user data to be tracked.

Conditions Conditions Conditions Conditions

取得用於限定活動的條件集合,這個活動是要追蹤且必須發出使用者資料的來源活動。Gets a collection of conditions that are used to qualify the activity from which the user data must be emitted to be tracked.

KeyName KeyName KeyName KeyName

取得或設定名稱,使用者資料必須與此名稱建立關聯才能比對 UserTrackingLocationGets or sets the name with which the user data must be associated for the UserTrackingLocation to be matched.

MatchDerivedActivityTypes MatchDerivedActivityTypes MatchDerivedActivityTypes MatchDerivedActivityTypes

取得或設定值,這個值會指出自 ActivityTypeActivityTypeName 指定之活動類型衍生的活動中發出使用者資料時,是否應追蹤使用者資料。Gets or sets a value that indicates whether the user data should be tracked when it is emitted from activities derived from the activity type specified by ActivityType or ActivityTypeName.

MatchDerivedArgumentTypes MatchDerivedArgumentTypes MatchDerivedArgumentTypes MatchDerivedArgumentTypes

使用者追蹤位置是一個篩選使用者追蹤資料的方式。The User tracking location is a way to filter user tracked data. 使用者可以指定 ArgumentTypeArgumentTypeName,根據使用者追蹤資料的類型來篩選。The user can filter by the type of the user tracked data by specifying the ArgumentType or ArgumentTypeName. MatchDerivedArgumentTypes 設為 true,會指定使用者追蹤資料可以是 ArgumentType/ArgumentTypeName 型別,或是衍生自 ArgumentType/ArgumentTypeName 的型別。Setting the MatchDerivedArgumentTypes to true specifies that the user tracked data can be of type ArgumentType/ArgumentTypeName or a type derived from the ArgumentType/ArgumentTypeName.

方法

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)

適用於