UserTrackPoint 类

定义

命名空间:

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 UserTrackPoint sealed

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

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

Public NotInheritable Class UserTrackPoint

继承

Object

UserTrackPoint

属性

ObsoleteAttribute

注解

注意

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

活动设计器或工作流设计器可以使用重载 Activity.TrackData 和 ActivityExecutionContext.TrackData 方法来检测工作流，以便采用用户事件的形式将数据发出到运行时跟踪基础结构。 发出的数据称为用户数据。 与只会在状态更改时发生的活动状态事件和工作流状态事件不同，用户事件可以在工作流中检测到的任何位置发生。 检测工作流发出用户事件的原因有很多。 例如，工作流设计器可能需要传递有关工作流进度的逻辑状态信息，或者，活动设计器可能需要在其他时候（而非活动状态更改时）为活动成员提供机会。

UserTrackPoint 在与用户事件关联的根工作流实例的可能执行路径中定义一个关注点。 UserTrackPoint 包含匹配中包括的位置、从匹配中排除的位置，以及应在跟踪点匹配时从工作流实例中提取的任何附加数据。 您可以将 UserTrackPoint 添加到 TrackingProfile.UserTrackPoints，以指示运行时跟踪基础结构在跟踪点匹配时将 UserTrackingRecord 发送到跟踪服务。 用户数据在 UserTrackingRecord.UserData 中返回。 可以在工作流实例中的多个点匹配单一 UserTrackPoint。

UserTrackingLocation 包含工作流实例的可能执行路径中与用户事件关联的位置的匹配条件。 您可以将 UserTrackingLocation 对象添加到 MatchingLocations 以定义应包括在跟踪点匹配中的位置。 同样，您可以将 UserTrackingLocation 对象添加到 ExcludedLocations 以定义应从跟踪点匹配中排除的位置。

您可以将 ActivityDataTrackingExtract 对象和 WorkflowDataTrackingExtract 对象添加到 Extracts，以指定在跟踪点匹配时应从工作流实例中提取的数据。 提取的数据将在 UserTrackingRecord.Body 中返回。

您可以在 Annotations 中添加内容，以指定与跟踪点关联的附加信息。 这些批注将在 UserTrackPoint.Annotations 中返回。

有关如何使用此类的示例，请参阅 使用用户跟踪点进行跟踪示例。

构造函数

UserTrackPoint()

已过时. 初始化 UserTrackPoint 类的新实例。

属性

Annotations	已过时. 获取与跟踪点关联的批注的集合。
ExcludedLocations	已过时. 获取运行时跟踪基础结构应从跟踪点中排除的位置的集合。
Extracts	已过时. 获取一个集合，该集合指定要从工作流实例中提取并发送到跟踪服务的数据。
MatchingLocations	已过时. 获取运行时跟踪基础结构应包括在跟踪点匹配中的位置的集合。

方法

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