Activity 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
注意
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")]
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.*")]
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")>]
type Activity = class
inherit 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
- 继承
- 派生
- 属性
示例
此示例定义用于发送电子邮件的活动。 该活动定义一个在相应实现中使用依赖项属性的 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) |
已过时.
|
字段
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。 |
方法
事件
Canceling |
已过时.
在取消活动执行时发生。 |
Closed |
已过时.
在 Activity 完成执行时发生。 |
Compensating |
已过时.
在 Activity 上运行补偿方法时发生。 |
Executing |
已过时.
在运行 Activity 时发生。 |
Faulting |
已过时.
在实例的运行期间引发异常时发生。 |
StatusChanged |
已过时.
在运行中的 ActivityExecutionStatus 的 Activity 更改时发生。 |
显式接口实现
IComponent.Disposed |
已过时.
表示处理组件的“Disposed”事件的方法。 (继承自 DependencyObject) |