UserTrackingLocation 类

定义

命名空间:

System.Workflow.Runtime.Tracking

程序集:

System.Workflow.Runtime.dll

注意

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

定义与根工作流实例的可能执行路径中的某个用户事件相对应的活动限定位置。 此类不能被继承。

public ref class UserTrackingLocation sealed

[System.Serializable]
public sealed class UserTrackingLocation

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

[<System.Serializable>]
type UserTrackingLocation = class

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

Public NotInheritable Class UserTrackingLocation

继承

Object

UserTrackingLocation

属性

SerializableAttribute ObsoleteAttribute

注解

备注

本材料讨论的类型和命名空间已废弃不用。 有关详细信息，请参阅 Windows Workflow Foundation 4.5 中弃用的类型。

活动设计器或工作流设计器可以使用任何重载 Activity.TrackData 和 ActivityExecutionContext.TrackData 方法来检测工作流，以便采用用户事件的形式将数据发出到运行时跟踪基础结构。 发出的数据称为用户数据。 与只会在活动或工作流状态更改时发生的活动状态事件和工作流状态事件不同，用户事件可以在工作流中检测到的任何位置发生。 UserTrackingLocation 通过指定以下各项为这种位置定义匹配参数：用户数据的类型、必须从中发出用户数据的活动的类型、可以对此活动的一个或多个实例加以更精确限定的条件的集合、用户数据必须与之关联的可选键名、用户数据的派生类型是否应匹配，以及从活动（派生自指定活动的类型）中发出的用户数据是否应匹配。

备注

单一 UserTrackingLocation 可以引用工作流实例的可能执行路径中的多个实际位置。

您可以将 UserTrackingLocation 添加到 UserTrackPoint.MatchingLocations 或 UserTrackPoint.ExcludedLocations，以便为 UserTrackPoint 中的 TrackingProfile 定义匹配参数。

对于要由运行时跟踪基础结构匹配的 UserTrackingLocation，必须按如下顺序满足以下三个一般条件：发出用户事件的活动必须与 ActivityType、ActivityTypeName、Conditions 和 MatchDerivedActivityTypes 指定的活动集合相匹配；与用户数据关联的键（如果存在）必须与 KeyName 相匹配；并且，用户事件发出的用户数据的类型必须与 ArgumentType、ArgumentTypeName 和 MatchDerivedArgumentTypes 指定的用户数据类型的集合相匹配。 只有在所有这三个条件都得到满足时，运行时跟踪基础结构才会认为 UserTrackingLocation 匹配。

若要配置 UserTrackingLocation，必须设置 ArgumentTypeName 或 ArgumentType 以指定要匹配的用户数据类型，并设置 ActivityTypeName 或 ActivityType 以指定必须从中发出要匹配的用户数据的活动类型。 您可以将 ActivityTrackingCondition 对象添加到 Conditions，以便更完全地限定必须从中发出用户数据的活动。 您可以设置 MatchDerivedArgumentTypes，以指定应当匹配派生自用户数据类型（由 ArgumentTypeName 或 ArgumentType 指定）的用户数据，并且可以设置 MatchDerivedActivityTypes，以指定应当匹配从派生自活动类型（由 ActivityTypeName 或 ActivityType 指定）的活动中发出的用户数据。

您可以设置 KeyName 以指定只应为此 UserTrackingLocation 匹配与指定键名关联的用户数据。 如果 KeyName 为空引用（在 Visual Basic 中为 Nothing），运行时跟踪结构将不会尝试匹配与用户数据关联的键。

构造函数

UserTrackingLocation()	初始化 UserTrackingLocation 类的新实例。
UserTrackingLocation(String)	使用用户数据的公共语言运行库 (CLR) 类型的非限定名称初始化 UserTrackingLocation 类的新实例。
UserTrackingLocation(String, String)	使用用户数据的公共语言运行库 (CLR) 类型的非限定名称以及活动（必须从中发出用户数据）的 CLR 类型的非限定名称初始化 UserTrackingLocation 类的新实例。
UserTrackingLocation(String, Type)	使用用户数据的公共语言运行库 (CLR) 类型的非限定名称以及活动（必须从中发出用户数据）的 CLR 类型初始化 UserTrackingLocation 类的新实例。
UserTrackingLocation(Type)	使用用户数据的公共语言运行库 (CLR) 类型初始化 UserTrackingLocation 类的新实例。
UserTrackingLocation(Type, String)	使用用户数据的公共语言运行库 (CLR) 类型以及活动（必须从中发出用户数据）的 CLR 类型的非限定名称初始化 UserTrackingLocation 类的新实例。
UserTrackingLocation(Type, Type)	使用用户数据的公共语言运行库 (CLR) 类型以及活动（必须从中发出用户数据）的 CLR 类型初始化 UserTrackingLocation 类的新实例。

属性

ActivityType	获取或设置必须从中发出要跟踪的用户数据的活动的公共语言运行库 (CLR) 类型。
ActivityTypeName	获取或设置必须从中发出要跟踪的用户数据的活动的公共语言运行库 (CLR) 类型的非限定名称。
ArgumentType	获取或设置要跟踪的用户数据的公共语言运行库 (CLR) 类型。
ArgumentTypeName	获取或设置要跟踪的用户数据的公共语言运行库 (CLR) 类型的非限定名称。
Conditions	获取一个条件集合，这些条件用于限定必须从中发出要跟踪的用户数据的活动。
KeyName	获取或设置名称，用户数据必须与该名称关联才能使 UserTrackingLocation 得以匹配。
MatchDerivedActivityTypes	获取或设置一个值，该值指定在从派生自活动类型（由 ActivityType 或 ActivityTypeName 指定）的活动中发出用户数据时，是否应对用户数据进行跟踪。
MatchDerivedArgumentTypes	可以通过用户跟踪位置来筛选用户跟踪的数据。 通过指定 ArgumentType 或 ArgumentTypeName，用户可以按用户跟踪数据的类型进行筛选。 如果将 MatchDerivedArgumentTypes 设置为 true，则指定用户跟踪的数据可以为 ArgumentType/ArgumentTypeName 类型，或者是派生自 ArgumentType/ArgumentTypeName 的类型。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)