MessageQueue.ReceiveByCorrelationId メソッド (String, MessageQueueTransactionType)

[アーティクル]
03/28/2008

指定した相関 ID と一致するメッセージを受信します。現在、指定した相関 ID と一致するメッセージがキューに存在しない場合は、すぐに例外を発生させます。

Overloads Public Function ReceiveByCorrelationId( _
   ByVal correlationId As String, _   ByVal transactionType As MessageQueueTransactionType _) As Message
[C#]
public Message ReceiveByCorrelationId(stringcorrelationId,MessageQueueTransactionTypetransactionType);
[C++]
public: Message* ReceiveByCorrelationId(String* correlationId,MessageQueueTransactionTypetransactionType);
[JScript]
public function ReceiveByCorrelationId(
   correlationId : String,transactionType : MessageQueueTransactionType) : Message;

パラメータ

correlationId
受信するメッセージの CorrelationId 。
transactionType
メッセージと関連付けるトランザクションコンテキストの種類を示す、 MessageQueueTransactionType 値の 1 つ。

戻り値

渡された correlationId パラメータと一致する CorrelationId を持つ Message 。

例外

例外の種類	条件
ArgumentNullException	correlationId パラメータが null 参照 (Visual Basic では Nothing) です。
InvalidOperationException	指定した correlationId を持つメッセージは見つかりませんでした。
InvalidEnumArgumentException	transactionType パラメータが、 MessageQueueTransactionType メンバの値ではありません。
MessageQueueException	メッセージキューの API にアクセスしたときにエラーが発生しました。

解説

このメソッドは、 MessageQueue が参照するキューで、 CorrelationId が指定した correlationId パラメータと一致するメッセージを検索します。 correlationID パラメータと一致するメッセージが見つからない場合は、例外がスローされます。見つかった場合は、 transactionType パラメータで定義されたトランザクションコンテキストを使用してメッセージがキューから削除され、アプリケーションに返されます。

既に、メッセージの受信に使用するスレッドに結び付けられた外部トランザクションコンテキストがある場合は、 transactionType パラメータに Automatic を指定します。メッセージを単一の内部トランザクションとして受信する場合は、 Single を指定します。トランザクションコンテキスト外部のトランザクションキューからメッセージを受信する場合は、 None を指定します。

このメソッドは、トランザクションキューからメッセージを受信するために呼び出され、トランザクションが中止されると、受信したメッセージがキューに戻されます。メッセージは、トランザクションがコミットされるまで、キューから恒久的に削除されることはありません。

キューに送信したメッセージを、関連付けられている応答、レポート、または受信確認の各メッセージと結び付ける場合は、 CorrelationId プロパティを使用します。

その他の 2 つのメソッドを使用すると、キューからメッセージを受信できます。 Receive メソッドは、キューの最初のメッセージを返します。一意の ID を指定してメッセージを取得するには、 ReceiveById メソッドを使用します。

指定した相関 ID を持つメッセージをキューから削除せずに読み取るには、 PeekByCorrelationId メソッドを使用します。 PeekByCorrelationId メソッドは、常にキューの最初のメッセージを返します。そのため、より優先順位の高いメッセージがそのキューに到達するまで、後続の呼び出しでも同じメッセージが返されます。 PeekByCorrelationId の呼び出しによって返されるメッセージに関連付けられたトランザクションコンテキストはありません。 PeekByCorrelationId はキューのメッセージを削除しないため、トランザクションが中止されても何もロールバックされません。

このメソッドが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	はい
ローカルコンピュータ + 直接書式名	はい
リモートコンピュータ	いいえ
リモートコンピュータ + 直接書式名	はい

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用

参照

次の方法で共有

MessageQueue.ReceiveByCorrelationId メソッド (String, MessageQueueTransactionType)

パラメータ

戻り値

例外

解説

必要条件

参照

その他のリソース