WhileActivity 类

定义

命名空间:

System.Workflow.Activities

程序集:

System.Workflow.Activities.dll

注意

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

只要某个条件为 true，就以迭代方式运行子活动。

public ref class WhileActivity sealed : System::Workflow::ComponentModel::CompositeActivity, System::Workflow::ComponentModel::IActivityEventListener<System::Workflow::ComponentModel::ActivityExecutionStatusChangedEventArgs ^>

[System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.WhileActivity), "Resources.While.png")]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.WhileValidator))]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public sealed class WhileActivity : System.Workflow.ComponentModel.CompositeActivity, System.Workflow.ComponentModel.IActivityEventListener<System.Workflow.ComponentModel.ActivityExecutionStatusChangedEventArgs>

[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.WhileActivity), "Resources.While.png")>]
[<System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.WhileValidator))>]
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type WhileActivity = class
    inherit CompositeActivity
    interface IActivityEventListener<ActivityExecutionStatusChangedEventArgs>

Public NotInheritable Class WhileActivity
Inherits CompositeActivity
Implements IActivityEventListener(Of ActivityExecutionStatusChangedEventArgs)

继承

Object

DependencyObject

Activity

CompositeActivity

WhileActivity

属性

ToolboxBitmapAttribute ActivityValidatorAttribute ObsoleteAttribute

实现

IActivityEventListener<ActivityExecutionStatusChangedEventArgs>

示例

下面的代码示例演示如何创建 WhileActivity 类的新实例，并将 ParallelActivity 类添加到 WhileActivity 类。 此代码示例是 WhileAndParallelWorkflow.Designer.cs 文件中 WhileAndParallel SDK 示例的一部分。 有关详细信息，请参阅 使用 While 和 Parallel。

workflowRuntime.WorkflowUnloaded += OnWorkflowUnload;

AddHandler currentWorkflowRuntime.WorkflowUnloaded, AddressOf OnWorkflowUnloaded

注解

注意

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

WhileActivity 是一种 CompositeActivity，这意味着 WhileActivity 可以包含其他活动。

在每次迭代之前，将计算 Condition 属性。 如果 Condition 属性的计算结果为 false，则 WhileActivity 将立即完成。

构造函数

WhileActivity()	已过时. 初始化 WhileActivity 类的新实例。
WhileActivity(String)	已过时. 使用活动的名称初始化 WhileActivity 类的新实例。

字段

ConditionProperty

已过时. 表示面向 Condition 属性的 DependencyProperty。

属性

Activities	已过时. 获取表示所有子活动的集合 ActivityCollection的对象。 (继承自 CompositeActivity)
CanModifyActivities	已过时. 获取或设置一个值，该值控制是否可以修改 Activities 中的单个活动。 (继承自 CompositeActivity)
Condition	已过时. 获取或设置一个条件，该条件确定 WhileActivity 应运行还是完成。
Description	已过时. 获取或设置 Activity的用户定义说明。 (继承自 Activity)
DesignMode	已过时. 获取一个值，该值指示此实例是处于设计模式还是运行时模式。 (继承自 DependencyObject)
DynamicActivity	已过时. 获取 WhileActivity中的动态子活动。
Enabled	已过时. 获取或设置一个值，该值指示是否为执行和验证启用此实例。 (继承自 Activity)
EnabledActivities	已过时. 获取表示已启用 Activities 子集的只读集合。 (继承自 CompositeActivity)
ExecutionResult	已过时. 获取上次运行此实例的尝试 ActivityExecutionResult。 (继承自 Activity)
ExecutionStatus	已过时. 获取此实例的当前 ActivityExecutionStatus。 (继承自 Activity)
IsDynamicActivity	已过时. 获取有关活动是否在工作流实例的默认 ActivityExecutionContext 内执行的信息。 (继承自 Activity)
Name	已过时. 获取或设置此实例的名称。 此名称必须符合工作流项目中使用的编程语言的变量命名约定。 (继承自 Activity)
Parent	已过时. 获取包含此 Activity的 CompositeActivity。 (继承自 Activity)
ParentDependencyObject	已过时. 获取 DependencyObject 图中的父 DependencyObject。 (继承自 DependencyObject)
QualifiedName	已过时. 获取活动的限定名称。 限定的活动名称在工作流实例中始终是唯一的。 (继承自 Activity)
Site	已过时. 获取或设置对 DependencyObjectSite 组件的引用。 (继承自 DependencyObject)
UserData	已过时. 获取将自定义数据与此类实例关联的 IDictionary。 (继承自 DependencyObject)
WorkflowInstanceId	已过时. 获取与实例关联的 Guid。 (继承自 Activity)

方法

AddHandler(DependencyProperty, Object)	已过时. 为 DependencyObject的事件添加处理程序。 (继承自 DependencyObject)
ApplyWorkflowChanges(WorkflowChanges)	已过时. 将参数中的 WorkflowChanges 清单应用于此实例。 (继承自 CompositeActivity)
Cancel(ActivityExecutionContext)	已过时. 由工作流运行时调用以取消当前正在执行的活动的执行。 (继承自 Activity)
Clone()	已过时. 创建 Activity的深层副本。 (继承自 Activity)
Dispose()	已过时. 释放 DependencyObject使用的所有资源。 (继承自 DependencyObject)
Dispose(Boolean)	已过时. 对此实例 Dispose(Boolean) 调用，并选择性地调用此实例的所有子活动 Dispose()。 (继承自 CompositeActivity)
Equals(Object)	已过时. 确定指定的对象是否等于当前对象。 (继承自 Object)
Execute(ActivityExecutionContext)	已过时. 由工作流运行时调用以执行活动。 (继承自 Activity)
GetActivityByName(String, Boolean)	已过时. 返回 Activity 的实例，如果第二个参数 false，则返回从根 Activity 目录下的所有活动（如果第二个参数为 false）和当前 Activity 下（如果第二个参数 true）。 (继承自 Activity)
GetActivityByName(String)	已过时. 返回从此实例的根活动（位于工作流中）下运行的所有活动的集合中请求其名称的 Activity 实例。 (继承自 Activity)
GetBinding(DependencyProperty)	已过时. 提供对与特定 DependencyProperty关联的 ActivityBind 的访问权限。 (继承自 DependencyObject)
GetBoundValue(ActivityBind, Type)	已过时. 检索作为 ActivityBind主题的 Object。 (继承自 DependencyObject)
GetDynamicActivities(Activity)	已过时. 返回一个数组，该数组包含指定活动的所有当前正在执行的实例。 (继承自 CompositeActivity)
GetHashCode()	已过时. 用作默认哈希函数。 (继承自 Object)
GetInvocationList<T>(DependencyProperty)	已过时. 获取一个数组，该数组包含指定 DependencyProperty的委托。 (继承自 DependencyObject)
GetType()	已过时. 获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	已过时. 提供对指定 DependencyProperty值的访问权限。 (继承自 DependencyObject)
GetValueBase(DependencyProperty)	已过时. 提供对 DependencyProperty 绑定对象的访问并绕过 GetValue(DependencyProperty) 替代。 (继承自 DependencyObject)
HandleFault(ActivityExecutionContext, Exception)	已过时. 在此实例的执行上下文中引发异常时调用。 (继承自 CompositeActivity)
Initialize(IServiceProvider)	已过时. 初始化此实例的所有适当子活动以及指定的 IServiceProvider。 (继承自 CompositeActivity)
InitializeProperties()	已过时. 在派生类中重写时，对依赖属性执行初始化。 (继承自 DependencyObject)
Invoke<T>(EventHandler<T>, T)	已过时. 订阅 EventHandler 并调用该委托。 (继承自 Activity)
Invoke<T>(IActivityEventListener<T>, T)	已过时. 订阅 IActivityEventListener<T> 并调用该委托。 (继承自 Activity)
IsBindingSet(DependencyProperty)	已过时. 指示 DependencyProperty 的值是否设置为绑定。 请参阅 SetBinding(DependencyProperty, ActivityBind)。 (继承自 DependencyObject)
MemberwiseClone()	已过时. 创建当前 Object的浅表副本。 (继承自 Object)
MetaEquals(DependencyObject)	已过时. 确定此 DependencyObject 的 metaproperties 是否等于参数化 DependencyObject的 metaproperties。 (继承自 DependencyObject)
OnActivityChangeAdd(ActivityExecutionContext, Activity)	已过时. 添加活动时调用。 (继承自 CompositeActivity)
OnActivityChangeRemove(ActivityExecutionContext, Activity)	已过时. 删除活动时调用。 (继承自 CompositeActivity)
OnActivityExecutionContextLoad(IServiceProvider)	已过时. 每次加载此活动的 ActivityExecutionContext 时，工作流运行时引擎都会调用该引擎。 (继承自 CompositeActivity)
OnActivityExecutionContextUnload(IServiceProvider)	已过时. 每次卸载此活动的 ActivityExecutionContext 时，工作流运行时引擎都会调用。 (继承自 CompositeActivity)
OnClosed(IServiceProvider)	已过时. 由工作流运行时调用，作为活动转换为关闭状态的一部分。 (继承自 Activity)
OnListChanged(ActivityCollectionChangeEventArgs)	已过时. 在 Activities 属性更改时执行其他处理。 (继承自 CompositeActivity)
OnListChanging(ActivityCollectionChangeEventArgs)	已过时. 在对基础 Activities进行更改之前发生的事件。 (继承自 CompositeActivity)
OnWorkflowChangesCompleted(ActivityExecutionContext)	已过时. 在此实例的集合 Activities 进行更改后调用。 (继承自 CompositeActivity)
RaiseEvent(DependencyProperty, Object, EventArgs)	已过时. 引发与指定依赖属性关联的 Event。 (继承自 Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)	已过时. 引发与所引用 DependencyProperty关联的事件。 (继承自 Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	已过时. 为状态更改事件注册指定的 DependencyProperty。 (继承自 Activity)
RemoveHandler(DependencyProperty, Object)	已过时. 从关联的 DependencyProperty中删除 EventHandler。 (继承自 DependencyObject)
RemoveProperty(DependencyProperty)	已过时. 从 DependencyObject中删除 DependencyProperty。 (继承自 DependencyObject)
Save(Stream, IFormatter)	已过时. 使用为序列化提供的自定义 IFormatter 将 Activity 写入 Stream 以供持久性。 (继承自 Activity)
Save(Stream)	已过时. 将 Activity 写入 Stream 以供持久性。 (继承自 Activity)
SetBinding(DependencyProperty, ActivityBind)	已过时. 设置指定 DependencyProperty的 ActivityBind。 (继承自 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()	已过时. 提供表示此实例的字符串。 (继承自 Activity)
TrackData(Object)	已过时. 通知运行时跟踪基础结构挂起的跟踪信息。 (继承自 Activity)
TrackData(String, Object)	已过时. 通知运行时跟踪基础结构挂起的跟踪信息。 (继承自 Activity)
Uninitialize(IServiceProvider)	已过时. 当活动从 Initialized 状态转换为 Closed 状态时，由工作流运行时引擎调用。 (继承自 CompositeActivity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	已过时. 取消注册状态更改事件的指定 DependencyProperty。 (继承自 Activity)

事件

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

显式接口实现

IActivityEventListener<ActivityExecutionStatusChangedEventArgs>.OnEvent(Object, ActivityExecutionStatusChangedEventArgs)	已过时. 定义订阅事件发生时的处理过程。
IComponent.Disposed	已过时. 表示处理组件的 Disposed 事件的方法。 (继承自 DependencyObject)

另请参阅

• 使用 While 活动
• 在工作流中使用条件