Activity 类

定义

命名空间:

System.Workflow.ComponentModel

程序集:

System.Workflow.ComponentModel.dll

注意

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

表示工作流的基本构造块。 Activity 是所有活动的基类。

public ref class Activity : System::Workflow::ComponentModel::DependencyObject

[System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.Activity), "Design.Resources.Activity.png")]
[System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator(typeof(System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator))]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.ComponentModel.Compiler.ActivityValidator))]
[System.Workflow.ComponentModel.Serialization.RuntimeNameProperty("Name")]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public class Activity : System.Workflow.ComponentModel.DependencyObject

[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.ComponentModel.Activity), "Design.Resources.Activity.png")>]
[<System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator(typeof(System.Workflow.ComponentModel.Compiler.ActivityCodeGenerator))>]
[<System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.ComponentModel.Compiler.ActivityValidator))>]
[<System.Workflow.ComponentModel.Serialization.RuntimeNameProperty("Name")>]
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type Activity = class
    inherit DependencyObject

Public Class Activity
Inherits DependencyObject

继承

Object

DependencyObject

Activity

派生

System.Workflow.Activities.CallExternalMethodActivity

System.Workflow.Activities.CodeActivity

System.Workflow.Activities.DelayActivity

System.Workflow.Activities.HandleExternalEventActivity

System.Workflow.Activities.InvokeWebServiceActivity

System.Workflow.Activities.InvokeWorkflowActivity

System.Workflow.Activities.PolicyActivity

System.Workflow.Activities.SendActivity

System.Workflow.Activities.SetStateActivity

System.Workflow.Activities.WebServiceFaultActivity

System.Workflow.Activities.WebServiceInputActivity

System.Workflow.Activities.WebServiceOutputActivity

System.Workflow.ComponentModel.CompensateActivity

System.Workflow.ComponentModel.CompositeActivity

System.Workflow.ComponentModel.SuspendActivity

System.Workflow.ComponentModel.TerminateActivity

System.Workflow.ComponentModel.ThrowActivity

属性

ToolboxBitmapAttribute ActivityCodeGeneratorAttribute ActivityValidatorAttribute RuntimeNamePropertyAttribute ObsoleteAttribute

示例

此示例定义用于发送电子邮件的活动。 该活动定义一个在相应实现中使用依赖项属性的 Subject 属性。 可以采用类似的方法定义其他属性。 对 Execute 方法进行重写，以提供用于发送电子邮件的逻辑。 有关完整示例，请参阅发送Email活动示例。

public class SendEmail : Activity  
{  
    public static readonly DependencyProperty SubjectProperty =  
        DependencyProperty.Register("Subject", typeof(string), typeof(SendEmail));  

    public string Subject  
    {  
        get { return base.GetValue(SubjectProperty) as string; }  
        set { base.SetValue(SubjectProperty, value); }  
    }  

    // Define other properties...  

    protected override ActivityExecutionStatus Execute(ActivityExecutionContext executionContext)  
    {  
        // Logic to send the email goes here...  
        return ActivityExecutionStatus.Closed;  
    }  
}  

注解

注意

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

Activity 是工作流的基本构造块。 Activity 像任意类那样定义一组属性和事件，并定义执行逻辑，这些执行逻辑定义活动的运行时行为。 一组可以与 Activity 关联的附加组件。 这些组件包括但不限于验证程序、代码生成器、自定义序列化程序和设计器。

所有活动共享一组在 Activity 基类上定义的通用属性。 每个 Activity 都可以按照需要，通过扩展此类来声明各自的附加属性。 因为 Activity 派生自 DependencyObject，所以属性可以定义为标准 CLR 属性和依赖项属性。

Activity 的执行逻辑满足在任意 Activity 和工作流运行时之间存在的协定。 您必须在文档中按照功能记录任何 Activity 的执行逻辑，便于使用 Activity 的工作流开发人员了解其行为。 对于在工作流中包括活动的工作流开发人员，执行逻辑本身是不可见的，因为执行逻辑是在工作流运行时和 Activity 之间严格存在的协定的一部分。

构造函数

Activity()	已过时. 初始化 Activity 类的新实例。
Activity(String)	已过时. 初始化 Activity 类的新实例，同时初始化 Name。

字段

ActivityContextGuidProperty	已过时. DependencyProperty，表示与 Guid 关联的 ActivityExecutionContext 的 Activity。
CancelingEvent	已过时. 表示针对 DependencyProperty 事件的 Canceling。
ClosedEvent	已过时. 表示针对 DependencyProperty 事件的 Closed。
CompensatingEvent	已过时. 表示针对 DependencyProperty 事件的 Compensating。
ExecutingEvent	已过时. 表示针对 DependencyProperty 事件的 Executing，该事件在执行活动时发生。
FaultingEvent	已过时. 表示 DependencyProperty 事件的 Faulting。
StatusChangedEvent	已过时. 表示针对 DependencyProperty 事件的 StatusChanged。

属性

Description	已过时. 获取或设置 Activity 的用户定义说明。
DesignMode	已过时. 获取一个值，该值指示此实例是处于设计模式还是运行时模式。 (继承自 DependencyObject)
Enabled	已过时. 获取或设置一个值，该值指示是否启用此实例以供执行和验证。
ExecutionResult	已过时. 获取最后一次尝试运行此实例产生的 ActivityExecutionResult。
ExecutionStatus	已过时. 获取此实例的当前 ActivityExecutionStatus。
IsDynamicActivity	已过时. 获取有关活动是否在工作流实例的默认 ActivityExecutionContext 中执行的信息。
Name	已过时. 获取或设置此实例的名称。 此名称必须符合工作流项目中使用的编程语言的变量命名规则。
Parent	已过时. 获取包含此 CompositeActivity 的 Activity。
ParentDependencyObject	已过时. 获取 DependencyObject 图中的父 DependencyObject。 (继承自 DependencyObject)
QualifiedName	已过时. 获取活动的限定名。 活动的限定名在工作流实例中始终是唯一的。
Site	已过时. 获取或设置对 Site 的 DependencyObject 组件的引用。 (继承自 DependencyObject)
UserData	已过时. 获取一个 IDictionary，它将自定义数据与此类实例关联。 (继承自 DependencyObject)
WorkflowInstanceId	已过时. 获取与实例关联的 Guid。

方法

AddHandler(DependencyProperty, Object)	已过时. 为 DependencyObject 的事件添加处理程序。 (继承自 DependencyObject)
Cancel(ActivityExecutionContext)	已过时. 由工作流运行时调用，用于取消当前正在运行的活动执行。
Clone()	已过时. 创建 Activity 的深层副本。
Dispose()	已过时. 释放由 DependencyObject 占用的所有资源。 (继承自 DependencyObject)
Dispose(Boolean)	已过时. 释放非托管资源，还可以释放由 DependencyObject 占用的托管资源。 (继承自 DependencyObject)
Equals(Object)	已过时. 确定指定对象是否等于当前对象。 (继承自 Object)
Execute(ActivityExecutionContext)	已过时. 由工作流运行时调用，用于执行活动。
GetActivityByName(String)	已过时. 返回 Activity 的实例，其名称由此实例的根活动下（即在工作流中）运行的所有活动的集请求。
GetActivityByName(String, Boolean)	已过时. 返回 Activity 的实例，其名称被此实例的根 Activity 下的所有活动的集（如果第二个参数为 false）和当前 Activity 下的所有活动的集（如果第二个参数为 true）请求。
GetBinding(DependencyProperty)	已过时. 提供对与特定 ActivityBind 关联的 DependencyProperty 的访问。 (继承自 DependencyObject)
GetBoundValue(ActivityBind, Type)	已过时. 检索作为 Object 的主题的 ActivityBind。 (继承自 DependencyObject)
GetHashCode()	已过时. 作为默认哈希函数。 (继承自 Object)
GetInvocationList<T>(DependencyProperty)	已过时. 获取一个数组，其中包含指定的 DependencyProperty 的委托。 (继承自 DependencyObject)
GetType()	已过时. 获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	已过时. 提供对指定的 DependencyProperty 的值的访问。 (继承自 DependencyObject)
GetValueBase(DependencyProperty)	已过时. 提供对 DependencyProperty 的绑定对象的访问，并跳过 GetValue(DependencyProperty) 重写。 (继承自 DependencyObject)
HandleFault(ActivityExecutionContext, Exception)	已过时. 此实例的执行上下文中引发了异常时调用。
Initialize(IServiceProvider)	已过时. 由工作流运行时调用，用于在构造新的工作流实例期间初始化活动。 此方法在构造动态 ActivityExecutionContext 期间调用。
InitializeProperties()	已过时. 在派生类中重写时，对依赖属性执行初始化。 (继承自 DependencyObject)
Invoke<T>(EventHandler<T>, T)	已过时. 订阅 EventHandler 并调用该委托。
Invoke<T>(IActivityEventListener<T>, T)	已过时. 订阅 IActivityEventListener<T> 并调用该委托。
IsBindingSet(DependencyProperty)	已过时. 指示 DependencyProperty 的值是否设置为绑定。 请参阅 SetBinding(DependencyProperty, ActivityBind)。 (继承自 DependencyObject)
Load(Stream, Activity)	已过时. 从 Activity 加载 Stream 的实例。
Load(Stream, Activity, IFormatter)	已过时. 使用用于反序列化的自定义 Activity，从 Stream 加载 IFormatter 的实例。
MemberwiseClone()	已过时. 创建当前 Object 的浅表副本。 (继承自 Object)
MetaEquals(DependencyObject)	已过时. 确定此 metaproperties 的 DependencyObject 是否等于参数化的 metaproperties 的 DependencyObject。 (继承自 DependencyObject)
OnActivityExecutionContextLoad(IServiceProvider)	已过时. 每当加载 ActivityExecutionContext 时，由工作流运行时调用。 例如，在创建 ActivityExecutionContext 期间，以及每次在从持久性存储区中加载工作流实例期间重建 ActivityExecutionContext 时，会调用此方法。
OnActivityExecutionContextUnload(IServiceProvider)	已过时. 每当卸载 ActivityExecutionContext 时，由工作流运行时调用。 例如，在完成 ActivityExecutionContext 期间，以及每次在保留工作流实例期间卸载 ActivityExecutionContext 时，会调用此方法。
OnClosed(IServiceProvider)	已过时. 作为活动向 Closed 状态转换的一部分，由工作流运行时调用。
RaiseEvent(DependencyProperty, Object, EventArgs)	已过时. 引发与指定依赖属性关联的 Event。
RaiseGenericEvent<T>(DependencyProperty, Object, T)	已过时. 引发与引用的 DependencyProperty 关联的事件。
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	已过时. 为状态更改事件注册指定的 DependencyProperty。
RemoveHandler(DependencyProperty, Object)	已过时. 从关联的 EventHandler 中移除 DependencyProperty。 (继承自 DependencyObject)
RemoveProperty(DependencyProperty)	已过时. 从 DependencyProperty 中移除 DependencyObject。 (继承自 DependencyObject)
Save(Stream)	已过时. 将 Activity 写入到 Stream 以便进行保留。
Save(Stream, IFormatter)	已过时. 使用为序列化提供的自定义 Activity 将 Stream 写入到 IFormatter，以便进行保留。
SetBinding(DependencyProperty, ActivityBind)	已过时. 为指定的 ActivityBind 设置 DependencyProperty。 (继承自 DependencyObject)
SetBoundValue(ActivityBind, Object)	已过时. 设置目标 ActivityBind 的值。 (继承自 DependencyObject)
SetReadOnlyPropertyValue(DependencyProperty, Object)	已过时. 设置只读的 DependencyProperty 值。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	已过时. 将 DependencyProperty 的值设置为对象。 (继承自 DependencyObject)
SetValueBase(DependencyProperty, Object)	已过时. 通过跳过 DependencyProperty，将 Object 的值设置为指定的 SetValue(DependencyProperty, Object)。 (继承自 DependencyObject)
ToString()	已过时. 提供表示此实例的字符串。
TrackData(Object)	已过时. 向运行时跟踪基础结构通知有关挂起跟踪的信息。
TrackData(String, Object)	已过时. 向运行时跟踪基础结构通知有关挂起跟踪的信息。
Uninitialize(IServiceProvider)	已过时. 当在派生类中重写时，为活动提供由服务提供程序执行的反初始化。
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	已过时. 注销状态更改事件的指定 DependencyProperty。

事件

Canceling	已过时. 在取消活动执行时发生。
Closed	已过时. 在 Activity 完成执行时发生。
Compensating	已过时. 在 Activity 上运行补偿方法时发生。
Executing	已过时. 在运行 Activity 时发生。
Faulting	已过时. 在实例的运行期间引发异常时发生。
StatusChanged	已过时. 在运行中的 ActivityExecutionStatus 的 Activity 更改时发生。

显式接口实现

IComponent.Disposed

已过时. 表示处理组件的“Disposed”事件的方法。 (继承自 DependencyObject)