MessageQueue.PeekByLookupId メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
MSMQ 3.0 で導入されました。 キュー内の特定のメッセージをピークします。 メッセージは、参照識別子で指定することも、キューの前後の位置関係で指定することもできます。
オーバーロード
| PeekByLookupId(Int64) |
MSMQ 3.0 で導入されました。 非トランザクション キュー内の指定した参照識別子に一致するメッセージをピークします。 |
| PeekByLookupId(MessageLookupAction, Int64) |
MSMQ 3.0 で導入されました。 キュー内の特定のメッセージをピークします。 メッセージは、参照識別子で指定することも、キューの前後の位置関係で指定することもできます。 |
PeekByLookupId(Int64)
MSMQ 3.0 で導入されました。 非トランザクション キュー内の指定した参照識別子に一致するメッセージをピークします。
public:
System::Messaging::Message ^ PeekByLookupId(long lookupId);public System.Messaging.Message PeekByLookupId (long lookupId);member this.PeekByLookupId : int64 -> System.Messaging.MessagePublic Function PeekByLookupId (lookupId As Long) As Messageパラメーター
戻り値
渡された lookupId パラメーターと一致する LookupId プロパティを持つ Message。
例外
MSMQ 3.0 がインストールされていません。
指定した lookupId を持つメッセージは見つかりませんでした。
メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。
注釈
このメソッドを使用して、既知の参照識別子を含むメッセージをキューから削除せずに読み取ります。 メッセージがキューにない場合、このメソッドは例外を直ちにスローします。
メッセージの プロパティは LookupId 、メッセージが存在するキューに一意であるため、指定 lookupId されたパラメーターと一致するメッセージがキュー内に最大 1 つ存在します。
指定した参照識別子を持つメッセージを読み取り、キューから削除するには、 メソッドを ReceiveByLookupId 使用します。
次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。
| ワークグループ モード | 利用可能 |
|---|---|
| ローカル コンピューター | はい |
| ローカル コンピューターと直接形式の名前 | はい |
| リモート コンピューター | いいえ |
| リモート コンピューターと直接形式の名前 | はい |
こちらもご覧ください
適用対象
PeekByLookupId(MessageLookupAction, Int64)
MSMQ 3.0 で導入されました。 キュー内の特定のメッセージをピークします。 メッセージは、参照識別子で指定することも、キューの前後の位置関係で指定することもできます。
public:
System::Messaging::Message ^ PeekByLookupId(System::Messaging::MessageLookupAction action, long lookupId);public System.Messaging.Message PeekByLookupId (System.Messaging.MessageLookupAction action, long lookupId);member this.PeekByLookupId : System.Messaging.MessageLookupAction * int64 -> System.Messaging.MessagePublic Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As Messageパラメーター
- action
- MessageLookupAction
キュー内のメッセージを読み取る方法を指定する MessageLookupAction のいずれか 1 つ。 次のいずれかを指定します。
MessageLookupAction.Current。lookupId で指定されたメッセージをピークします。
MessageLookupAction.Next。lookupId で指定されたメッセージの次のメッセージをピークします。
MessageLookupAction.Previous。lookupId で指定されたメッセージの前のメッセージをピークします。
MessageLookupAction.First: キューの最初のメッセージをピークします。 lookupId パラメーターは、0 に設定する必要があります。
MessageLookupAction.Last: キューの最後のメッセージをピークします。 lookupId パラメーターは、0 に設定する必要があります。
戻り値
渡された action パラメーターおよび lookupId パラメーターで指定された Message。
例外
MSMQ 3.0 がインストールされていません。
指定した lookupId を持つメッセージは見つかりませんでした。
メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。
action パラメーターが、MessageLookupAction メンバーの 1 つではありません。
注釈
このメソッドを使用して、既知の参照識別子を含むメッセージをキューから削除せずに読み取ります。 メッセージがキューにない場合、このメソッドは例外を直ちにスローします。
メッセージの プロパティは LookupId 、メッセージが存在するキューに一意であるため、指定 lookupId されたパラメーターと一致するメッセージがキュー内に最大 1 つ存在します。
指定した識別子を持つメッセージを読み取り、キューから削除するには、 メソッドを ReceiveByLookupId 使用します。
次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。
| ワークグループ モード | 利用可能 |
|---|---|
| ローカル コンピューター | はい |
| ローカル コンピューターと直接形式の名前 | はい |
| リモート コンピューター | いいえ |
| リモート コンピューターと直接形式の名前 | はい |
こちらもご覧ください
適用対象
.NET