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 中即將淘汰的類型。

當工作流程實作 WCF 服務合約中定義的作業時，就會 ReceiveActivity 使用活動。 ReceiveActivity 可實作來自已定義服務合約的作業，也可定義工作流程本身內部的服務合約與作業。 後者稱為工作流程優先合約 (Workflow-first Contract)。

ReceiveActivity 活動支援一組預先定義的訊息交換模式。 這些模式包括：

• 單向接收

  傳送訊息的用戶端不預期服務會傳送回應。 合約作業必須有虛值 (Void) 傳回型別。

• 接收要求 – 傳送回應

  ReceiveActivity 活動接收並處理訊息之後，會將回應傳送回用戶端。 當合約作業具有虛值傳回型別時，就會將認可傳回到傳送活動。

• 接收要求 – 傳送錯誤

  ReceiveActivity 活動接收並處理訊息之後，會將回應或錯誤傳送回用戶端。

注意

為了確保持續性 (Persistence) 正確執行而且不保存暫時性訊息，請確定 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)
ApplyWorkflowChanges(WorkflowChanges)	已淘汰. 將參數中的 WorkflowChanges 資訊清單套用至這個執行個體。 (繼承來源 CompositeActivity)
Cancel(ActivityExecutionContext)	已淘汰. 取消執行活動。 (繼承來源 SequenceActivity)
Clone()	已淘汰. 建立 Activity 的深層複本 (Deep Copy)。 (繼承來源 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)	已淘汰. 判斷這個 的 是否相等於參數化 的 。 (繼承來源 DependencyObject)
OnActivityChangeAdd(ActivityExecutionContext, Activity)	已淘汰. 加入活動時呼叫。 (繼承來源 CompositeActivity)
OnActivityChangeRemove(ActivityExecutionContext, Activity)	已淘汰. 移除活動時呼叫。 (繼承來源 SequenceActivity)
OnActivityExecutionContextLoad(IServiceProvider)	已淘汰. 每次載入此活動的 ActivityExecutionContext 時，由工作流程執行階段引擎呼叫。 (繼承來源 CompositeActivity)
OnActivityExecutionContextUnload(IServiceProvider)	已淘汰. 每次卸載此活動的 ActivityExecutionContext 時，由工作流程執行階段引擎呼叫。 (繼承來源 CompositeActivity)
OnClosed(IServiceProvider)	已淘汰. 當活動轉換到已關閉狀態時，由工作流程執行階段呼叫。 (繼承來源 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 寫入保存性 (Persistence) 的 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	已淘汰. 發生於正在執行之 的 變更時。 (繼承來源 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