使用訊息活動

發行項
04/19/2011

本主題僅適用於 Windows Workflow Foundation 4。

訊息傳遞活動允許工作流程傳送和接收 WCF 訊息。藉由將訊息傳遞活動加入至工作流程，您就可以製作任何複雜訊息交換模式 (MEP) 的模型。

訊息交換模式

有三種基本的訊息交換模式：

資料包 - 使用資料包 MEP 時，用戶端會將訊息傳送至服務，但是服務不會回應。這種模式有時稱為「射後不理」(Fire And Forget)。射後不理交換是需要超出範圍確認成功傳遞的交換。訊息可能會在傳輸時遺失而永遠無法抵達服務。即使用戶端成功傳送訊息，也不會保證服務收到訊息。資料包是訊息的基本建置組塊，您可以在資料包的最上層建立自己的 MEP。
要求-回應 - 使用要求-回應 MEP 時，用戶端會將訊息傳送至服務，服務會執行必要的處理，然後將回應傳回至用戶端。此模式是由要求-回應組合所構成。遠端程序呼叫 (Remote Procedure Call，RPC) 與瀏覽器 GET 要求就是要求-回應呼叫的例子。這個模式又稱為半雙工。
雙工 - 使用雙工 MEP 時，用戶端和服務會依任意順序傳送訊息給彼此。雙工 MEP 就像是電話交談，談話中說出的每個字都是一則訊息。

訊息傳遞活動可讓您實作上述任何基本 MEP 以及各種複雜的 MEP。

訊息傳遞活動

.NET Framework 版本 4 會定義下列訊息傳遞活動：

Send - 使用 Send 活動傳送訊息。
SendReply - 使用 SendReply 活動傳送對所收到訊息的回應。此活動是工作流程服務在實作要求/回覆 MEP 時使用。
Receive - 使用 Receive 活動接收訊息。
ReceiveReply - 使用 ReceiveReply 活動接收回覆訊息。此活動是工作流程服務用戶端在實作要求/回覆 MEP 時使用。

訊息傳遞活動和訊息交換模式

資料包 MEP 包含傳送訊息的用戶端，以及接收訊息的服務。如果用戶端是工作流程，請使用 Send 活動傳送訊息。若要在工作流程中接收訊息，請使用 Receive 活動。Send 和 Receive 活動各有一個名為 Content 的屬性。此屬性包含要傳送或接收的資料。實作要求-回應 MEP 時，用戶端和服務都會使用多組活動。用戶端會使用 Send 活動傳送訊息，並且使用 ReceiveReply 活動接收來自服務的回應。這兩種活動之間是透過 Request 屬性建立關聯。此屬性會設定為傳送原始訊息的 Send 活動。服務也會使用一組關聯的活動：Receive 和 SendReply。這兩種活動之間是透過 Request 屬性建立關聯。此屬性會設定為接收原始訊息的 Receive 活動。ReceiveReply 和 SendReply 活動就像 Send 和 Receive，可讓您傳送 Message 執行個體或訊息合約型別。

由於工作流程會長時間執行，因此雙向通訊模式必須也支援長時間執行的對話。若要支援長時間執行的對話，初始化對話的用戶端必須讓服務可在之後資料能夠使用時回呼。例如，訂單要求提交讓管理員核准之後，可能經過一天、一週甚至一年都未處理；管理訂單核准的工作流程必須知道要在核准之後繼續執行。使用相互關聯的工作流程中可支援這種雙向通訊模式。若要實作雙工模式，請使用 Send 和 Receive 活動。在 Receive 活動上，使用特殊的 CallbackHandleName 索引鍵值初始化相互關聯。在 Send 活動上，將該相互關聯控制代碼設定為 CorrelatesWith 屬性值。如需詳細資訊，請參閱永久性雙工.

注意：
使用回呼相互關聯 (「永久性雙工」) 之工作流程的雙工實作主要用於長時間執行的對話。這與採用回呼合約的 WCF 雙工不同，後者會處理短時間執行 (通道的存留期) 的對話。

訊息格式和訊息傳遞活動

Receive 和 ReceiveReply 活動都有一個名為 Content 的屬性。此屬性的型別為 ReceiveContent，並且表示 Receive 或 ReceiveReply 活動接收的資料。.NET Framework 會定義分別稱為 RecieveMessageContent 和 ReceiveParametersContent 的兩個相關類別，兩者都是衍生自 ReceiveContent。將 Receive 或 ReceiveReply 活動的 Content 屬性設定為其中一種型別的執行個體，即可在工作流程服務中接收資料。要使用的型別是依據活動接收的資料型別而定。如果活動接收 Message 物件或訊息合約型別，則使用 ReceiveMessageContent。如果活動接收一組可序列化的資料合約或 XML 型別，則使用 ReceiveParametersContent。ReceiveParametersContent 可讓您傳送多個參數，而 ReceiveMessageContent 只能讓您傳送一個物件，也就是訊息 (或訊息合約型別)。

注意：
ReceiveMessageContent 也可以搭配可序列化的單一資料合約或 XML 型別使用。使用 ReceiveParametersContent 搭配單一參數與直接傳遞至 RecieveMessageContent 的物件之間的差異在於 Wire 格式。參數的內容是以對應於作業名稱的 XML 項目包裝，而序列化物件是以使用參數名稱的 XML 項目包裝 (例如 `<Echo><msg>Hello, World</msg></Echo>`)。訊息內容不會由作業名稱包裝。但是序列化物件會放置在使用 XML 限定型別名稱的 XML 項目內 (例如 `<string>Hello, World</string>`)。

注意：

ReceiveMessageContent 也可以搭配可序列化的單一資料合約或 XML 型別使用。使用 ReceiveParametersContent 搭配單一參數與直接傳遞至 RecieveMessageContent 的物件之間的差異在於 Wire 格式。參數的內容是以對應於作業名稱的 XML 項目包裝，而序列化物件是以使用參數名稱的 XML 項目包裝 (例如 <Echo><msg>Hello, World</msg></Echo>)。訊息內容不會由作業名稱包裝。但是序列化物件會放置在使用 XML 限定型別名稱的 XML 項目內 (例如 <string>Hello, World</string>)。

Send 和 SendReply 活動也有一個名為 Content 的屬性。此屬性的型別為 SendContent，並且表示 Send 或 SendReply 活動傳送的資料。.NET Framework 會定義分別稱為 SendMessageContent 和 SendParametersContent 的兩個相關型別，兩者都是衍生自 SendContent。將 Send 或 SendReply 活動的 Content 屬性設定為其中一種型別的執行個體，即可從工作流程服務傳送資料。要使用的類型是依據活動傳送的資料型別而定。如果活動傳送 Message 物件或訊息合約型別，則使用 SendMessageContent。如果活動傳送資料合約型別，則使用 SendParametersContent。SendParametersContent 可讓您傳送多個參數，而 SendMessageContent 只能讓您傳送一個物件，也就是訊息 (或訊息合約型別)。

以命令方式程式設計訊息傳遞活動時，可使用泛型 InArgument 和 OutArgument 包裝您指派給訊息的物件，或 Send、SendReply、Receive 和 ReceiveReply 活動的參數屬性。針對 Send 和 SendReply 活動使用 InArgument，並且針對 Receive 和 ReceiveReply 活動使用 OutArgument。In 引數會搭配傳送活動使用，因為資料會傳遞至活動內。Out 引數則搭配接收活動使用，因為資料會從活動傳出，如下列範例中所示。

Receive reserveSeat = new Receive
{ 
    ... 
    Content = new ReceiveParametersContent
    {
        Parameters =
        {
            { "ReservationInfo", new OutArgument<ReservationRequest>(reservationInfo) }
        }
    }
};
SendReply reserveSeat = new SendReply
{ 
    ... 
    Request = reserveSeat,
    Content = new SendParametersContent
    {
        Parameters =
        {
            { "ReservationId", new InArgument<string>(reservationId) }
        }
    },
};

實作定義以傳回 Void 之要求/回應作業的工作流程服務時，您必須具現化 SendReply 活動，並且將 Content 屬性設定為其中一個內容型別 (SendMesageContent 或 SendParametersContent) 的空執行個體，如下列範例中所示。

Receive rcv = new Receive()
{
ServiceContractName = "IService",
OperationName = "NullReturningContract",
Content = new ReceiveParametersContent( new Dictionary<string, OutArgument>() { { "message", new OutArgument<string>() } } )
};
SendReply sr = new SendReply()
{
Request = rcv
   Content = new SendParametersContent();
};

加入服務參考

從工作流程應用程式呼叫工作流程服務時，Visual Studio 2010 會產生自訂訊息傳遞活動，這些活動會封裝要求/回覆 MEP 中常用的 Send 和 ReceiveReply 活動。若要使用此功能，請以滑鼠右鍵按一下 Visual Studio 2010 中的用戶端專案，並選取 [加入服務參考]。在位址方塊中輸入服務的基底位址，然後按一下 [移至]。可用的服務會在 [服務:] 方塊中顯示。展開服務節點，即可顯示支援的合約。選取您要呼叫的合約，可用作業的清單就會出現在 [作業] 方塊中。然後您可以為產生的活動指定命名空間，並且按一下 [確定]。接著您會看見一個對話方塊，說明作業已成功完成，而且在您重建專案之後，產生的自訂活動會位於工具方塊內。服務合約中會針對每一項作業定義一個活動。重建專案之後，您可以拖放自訂活動至工作流程，並且在 [屬性] 視窗中設定任何必要的屬性。

訊息傳遞活動範本

為了讓您更容易在用戶端和服務上設定要求/回應 MEP，Visual Studio 2010 提供了兩個訊息傳遞活動範本。ReceiveAndSendReply 會用於服務上，SendAndReceiveReply 則會用於用戶端上。這兩種情況下，範本都會將適當的訊息傳遞活動加入至您的工作流程。在服務上，ReceiveAndSendReply 會加入 Receive 活動，後面接著 SendReply 活動。Request 屬性會自動設定為 Receive 活動。在用戶端上，SendAndReceiveReply 會加入 Send 活動，後面接著 ReceiveReply。Request 屬性會自動設定為 Send 活動。若要使用這兩個範本，只要將適當的範本拖放至您的工作流程即可。

訊息傳遞活動和交易

呼叫工作流程服務時，您可能想要讓交易流向服務作業。若要執行這項操作，請將 Receive 活動放置到 TransactedReceiveScope 活動內。TransactedReceiveScope 活動包含 Receive 活動和主體。流向服務的交易會在執行 TransactedReceiveScope 主體的整個過程中維持環境。當主體執行完成時，交易也會完成。如需詳細資訊工作流程和交易的詳細資料，請參閱工作流程交易。

共用方式為