ReceiveActivity 类

定义

命名空间:

System.Workflow.Activities

程序集:

System.WorkflowServices.dll

注意

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

服务活动，用于实现由 Windows Communication Foundation (WCF) 服务协定定义的操作。

public ref class ReceiveActivity sealed : System::Workflow::Activities::SequenceActivity, System::Workflow::Activities::IEventActivity, System::Workflow::ComponentModel::IActivityEventListener<System::Workflow::ComponentModel::QueueEventArgs ^>

[System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.ReceiveActivity), "Design.Resources.ReceiveActivity.png")]
[System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.ReceiveActivityValidator))]
[System.Serializable]
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public sealed class ReceiveActivity : System.Workflow.Activities.SequenceActivity, System.Workflow.Activities.IEventActivity, System.Workflow.ComponentModel.IActivityEventListener<System.Workflow.ComponentModel.QueueEventArgs>

[<System.Drawing.ToolboxBitmap(typeof(System.Workflow.Activities.ReceiveActivity), "Design.Resources.ReceiveActivity.png")>]
[<System.Workflow.ComponentModel.Compiler.ActivityValidator(typeof(System.Workflow.Activities.ReceiveActivityValidator))>]
[<System.Serializable>]
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type ReceiveActivity = class
    inherit SequenceActivity
    interface IEventActivity
    interface IActivityEventListener<QueueEventArgs>

Public NotInheritable Class ReceiveActivity
Inherits SequenceActivity
Implements IActivityEventListener(Of QueueEventArgs), IEventActivity

继承

Object

DependencyObject

Activity

CompositeActivity

SequenceActivity

ReceiveActivity

属性

ToolboxBitmapAttribute ActivityValidatorAttribute SerializableAttribute ObsoleteAttribute

实现

IEventActivity IActivityEventListener<QueueEventArgs>

注解

注意

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

当 ReceiveActivity 工作流实现 WCF 服务协定中定义的操作时，将使用 活动。 ReceiveActivity 可以实现已定义的服务协定中的操作，也可以在工作流本身中定义服务协定和操作。 后者称为工作流优先协定。

ReceiveActivity 活动支持一组预定义的消息交换模式。 这些模式包括：

• 单向接收

  发送消息的客户端不需要该服务发送响应。 协定操作应具有 void 返回类型。

• 接收请求 - 发送响应

  ReceiveActivity 活动接收并处理一条消息后，会向客户端发回一个响应。 如果协定操作具有 void 返回类型，则会向发送活动发回确认。

• 接收请求 - 发送错误

  ReceiveActivity 活动接收并处理一条消息后，会向客户端发回一个响应或错误。

注意

若要确保正确执行持久性且不保留瞬态消息，请确保 ReceiveActivity 的子活动自身不会持续。 例如，如果创建持久性提供程序时 UnloadOnIdle 设置为 true，则当子活动处于空闲状态时，可能发生这种情况。

注意

此活动是 .NET Framework 3.5 的一部分。 有关.NET Framework 4 中的等效活动，请参阅 Receive。

构造函数

ReceiveActivity()	已过时. 初始化 ReceiveActivity 类的新实例。
ReceiveActivity(String)	已过时. 初始化 ReceiveActivity 类的新实例，同时初始化其 Name 属性。

字段

FaultMessageProperty	已过时. 表示针对 DependencyProperty 属性的 FaultMessage。
OperationValidationEvent	已过时. 表示针对 DependencyProperty 事件的 OperationValidation。
WorkflowServiceAttributesProperty	已过时. 表示针对 DependencyProperty 属性的 ServiceOperationInfo。

属性

Activities	已过时. 获取表示所有子活动的集合 ActivityCollection 的对象。 (继承自 CompositeActivity)
CanCreateInstance	已过时. 获取或设置操作是否将导致创建新的工作流服务实例。
CanModifyActivities	已过时. 获取或设置一个值，该值控制是否可以修改 Activities 中的单个活动。 (继承自 CompositeActivity)
Context	已过时. 获取此活动的上下文信息。
ContextToken	已过时. 表示一个可用于指定上下文的令牌，应当使用该令牌来关联 ReceiveActivity 活动和该活动与之通信的客户端之间的交换。
Description	已过时. 获取或设置 Activity 的用户定义说明。 (继承自 Activity)
DesignMode	已过时. 获取一个值，该值指示此实例是处于设计模式还是运行时模式。 (继承自 DependencyObject)
Enabled	已过时. 获取或设置一个值，该值指示是否启用此实例以供执行和验证。 (继承自 Activity)
EnabledActivities	已过时. 获取表示已启用的 Activities 的子集的只读集合。 (继承自 CompositeActivity)
ExecutionResult	已过时. 获取最后一次尝试运行此实例产生的 ActivityExecutionResult。 (继承自 Activity)
ExecutionStatus	已过时. 获取此实例的当前 ActivityExecutionStatus。 (继承自 Activity)
FaultMessage	已过时. 接收活动完成执行时返回的异常。
IsDynamicActivity	已过时. 获取有关活动是否在工作流实例的默认 ActivityExecutionContext 中执行的信息。 (继承自 Activity)
Name	已过时. 获取或设置此实例的名称。 此名称必须符合工作流项目中使用的编程语言的变量命名规则。 (继承自 Activity)
ParameterBindings	已过时. 获取服务的形参表中可绑定参数的集合。
Parent	已过时. 获取包含此 CompositeActivity 的 Activity。 (继承自 Activity)
ParentDependencyObject	已过时. 获取 DependencyObject 图中的父 DependencyObject。 (继承自 DependencyObject)
QualifiedName	已过时. 获取活动的限定名。 活动的限定名在工作流实例中始终是唯一的。 (继承自 Activity)
ServiceOperationInfo	已过时. 定义 ReceiveActivity 活动实现的协定和服务操作。
Site	已过时. 获取或设置对 Site 的 DependencyObject 组件的引用。 (继承自 DependencyObject)
UserData	已过时. 获取一个 IDictionary，它将自定义数据与此类实例关联。 (继承自 DependencyObject)
WorkflowInstanceId	已过时. 获取与实例关联的 Guid。 (继承自 Activity)

方法

AddHandler(DependencyProperty, Object)	已过时. 为 DependencyObject 的事件添加处理程序。 (继承自 DependencyObject)
ApplyWorkflowChanges(WorkflowChanges)	已过时. 将参数中的 WorkflowChanges 清单应用到此实例。 (继承自 CompositeActivity)
Cancel(ActivityExecutionContext)	已过时. 取消活动的执行。 (继承自 SequenceActivity)
Clone()	已过时. 创建 Activity 的深层副本。 (继承自 Activity)
Dispose()	已过时. 释放由 DependencyObject 占用的所有资源。 (继承自 DependencyObject)
Dispose(Boolean)	已过时. 在此实例上调用 Dispose(Boolean)，并可以选择在此实例的所有子活动上调用 Dispose()。 (继承自 CompositeActivity)
Equals(Object)	已过时. 确定指定对象是否等于当前对象。 (继承自 Object)
Execute(ActivityExecutionContext)	已过时. 执行活动。 (继承自 SequenceActivity)
GetActivityByName(String)	已过时. 返回 Activity 的实例，其名称由此实例的根活动下（即在工作流中）运行的所有活动的集请求。 (继承自 Activity)
GetActivityByName(String, Boolean)	已过时. 返回 Activity 的实例，其名称被此实例的根 Activity 下的所有活动的集（如果第二个参数为 false）和当前 Activity 下的所有活动的集（如果第二个参数为 true）请求。 (继承自 Activity)
GetBinding(DependencyProperty)	已过时. 提供对与特定 ActivityBind 关联的 DependencyProperty 的访问。 (继承自 DependencyObject)
GetBoundValue(ActivityBind, Type)	已过时. 检索作为 Object 的主题的 ActivityBind。 (继承自 DependencyObject)
GetContext(Activity, ContextToken)	已过时. 静态方法，在给定活动实例和上下文令牌的情况下返回上下文信息。
GetContext(Activity, String, String)	已过时. 静态方法，在给定活动实例和上下文令牌的情况下返回上下文信息。
GetDynamicActivities(Activity)	已过时. 返回包含指定活动的所有当前正在执行的实例的数组。 (继承自 CompositeActivity)
GetHashCode()	已过时. 作为默认哈希函数。 (继承自 Object)
GetInvocationList<T>(DependencyProperty)	已过时. 获取一个数组，其中包含指定的 DependencyProperty 的委托。 (继承自 DependencyObject)
GetRootContext(Activity)	已过时. 静态方法，返回与给定活动实例关联的根上下文的上下文信息。 上下文信息用来在主机应用程序与工作流服务之间进行通信。
GetType()	已过时. 获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	已过时. 提供对指定的 DependencyProperty 的值的访问。 (继承自 DependencyObject)
GetValueBase(DependencyProperty)	已过时. 提供对 DependencyProperty 的绑定对象的访问，并跳过 GetValue(DependencyProperty) 重写。 (继承自 DependencyObject)
GetWorkflowServiceAttributes(Object)	已过时. 返回由 WorkflowServiceAttributes 活动实现的服务的 ReceiveActivity 属性。 这些属性包括多项，如 AddressFilterMode、ConfigurationName、IncludeExceptionDetailInFaults 和是否在从 ReceiveActivity 活动返回的任何错误中包括异常详细信息。
HandleFault(ActivityExecutionContext, Exception)	已过时. 此实例的执行上下文中引发了异常时调用。 (继承自 SequenceActivity)
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)	已过时. 确定此 metaproperties 的 DependencyObject 是否等于参数化的 metaproperties 的 DependencyObject。 (继承自 DependencyObject)
OnActivityChangeAdd(ActivityExecutionContext, Activity)	已过时. 在添加活动时调用。 (继承自 CompositeActivity)
OnActivityChangeRemove(ActivityExecutionContext, Activity)	已过时. 移除活动时调用。 (继承自 SequenceActivity)
OnActivityExecutionContextLoad(IServiceProvider)	已过时. 每次加载此活动的 ActivityExecutionContext 时由工作流运行时引擎调用。 (继承自 CompositeActivity)
OnActivityExecutionContextUnload(IServiceProvider)	已过时. 每次卸载此活动的 ActivityExecutionContext 时由工作流运行时引擎调用。 (继承自 CompositeActivity)
OnClosed(IServiceProvider)	已过时. 作为活动向 Closed 状态转换的一部分，由工作流运行时调用。 (继承自 Activity)
OnListChanged(ActivityCollectionChangeEventArgs)	已过时. 当 Activities 属性发生更改时，执行附加处理。 (继承自 CompositeActivity)
OnListChanging(ActivityCollectionChangeEventArgs)	已过时. 在对基础 Activities 进行更改之前发生的事件。 (继承自 CompositeActivity)
OnSequenceComplete(ActivityExecutionContext)	已过时. 在派生类中重写时，确定活动执行完毕后 SequenceActivity 需要执行的操作。 (继承自 SequenceActivity)
OnWorkflowChangesCompleted(ActivityExecutionContext)	已过时. 对此实例的集合 Activities 进行更改之后调用。 (继承自 SequenceActivity)
RaiseEvent(DependencyProperty, Object, EventArgs)	已过时. 引发与指定依赖属性关联的 Event。 (继承自 Activity)
RaiseGenericEvent<T>(DependencyProperty, Object, T)	已过时. 引发与引用的 DependencyProperty 关联的事件。 (继承自 Activity)
RegisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	已过时. 为状态更改事件注册指定的 DependencyProperty。 (继承自 Activity)
RemoveHandler(DependencyProperty, Object)	已过时. 从关联的 EventHandler 中移除 DependencyProperty。 (继承自 DependencyObject)
RemoveProperty(DependencyProperty)	已过时. 从 DependencyProperty 中移除 DependencyObject。 (继承自 DependencyObject)
Save(Stream)	已过时. 将 Activity 写入到 Stream 以便进行保留。 (继承自 Activity)
Save(Stream, IFormatter)	已过时. 使用为序列化提供的自定义 Activity 将 Stream 写入到 IFormatter，以便进行保留。 (继承自 Activity)
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)
SetWorkflowServiceAttributes(Object, Object)	已过时. 设置由 ReceiveActivity 活动实现的服务的属性。 这些属性包括多项，如 AddressFilterMode、ConfigurationName 和是否在从 ReceiveActivity 活动返回的任何错误中包括异常详细信息。
ToString()	已过时. 提供表示此实例的字符串。 (继承自 Activity)
TrackData(Object)	已过时. 向运行时跟踪基础结构通知有关挂起跟踪的信息。 (继承自 Activity)
TrackData(String, Object)	已过时. 向运行时跟踪基础结构通知有关挂起跟踪的信息。 (继承自 Activity)
Uninitialize(IServiceProvider)	已过时. 当活动从 Closed 状态转换到 Initialized 状态时，由工作流运行时引擎调用。 (继承自 CompositeActivity)
UnregisterForStatusChange(DependencyProperty, IActivityEventListener<ActivityExecutionStatusChangedEventArgs>)	已过时. 注销状态更改事件的指定 DependencyProperty。 (继承自 Activity)

事件

Canceling	已过时. 在取消活动执行时发生。 (继承自 Activity)
Closed	已过时. 在 Activity 完成执行时发生。 (继承自 Activity)
Compensating	已过时. 在 Activity 上运行补偿方法时发生。 (继承自 Activity)
Executing	已过时. 在运行 Activity 时发生。 (继承自 Activity)
Faulting	已过时. 在实例的运行期间引发异常时发生。 (继承自 Activity)
OperationValidation	已过时. 在接收到操作的消息并且需要验证时发生。
StatusChanged	已过时. 在运行中的 ActivityExecutionStatus 的 Activity 更改时发生。 (继承自 Activity)

显式接口实现

IActivityEventListener<ActivityExecutionStatusChangedEventArgs>.OnEvent(Object, ActivityExecutionStatusChangedEventArgs)	已过时. 定义发生订阅事件时的处理过程。 (继承自 SequenceActivity)
IActivityEventListener<QueueEventArgs>.OnEvent(Object, QueueEventArgs)	已过时. 定义发生订阅事件时的处理过程。
IComponent.Disposed	已过时. 表示处理组件的“Disposed”事件的方法。 (继承自 DependencyObject)
IEventActivity.QueueName	已过时. 获取该活动正在等待其数据到达的 WorkflowQueue 的名称。
IEventActivity.Subscribe(ActivityExecutionContext, IActivityEventListener<QueueEventArgs>)	已过时. 创建 ReceiveActivity 活动对事件的订阅。
IEventActivity.Unsubscribe(ActivityExecutionContext, IActivityEventListener<QueueEventArgs>)	已过时. 取消 Activity 对事件的订阅。

另请参阅

• SendActivity