Message.LookupId プロパティ

.NET Framework クラス ライブラリ リファレンス

Message.LookupId プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

MSMQ 3.0 で導入されました。メッセージの参照識別子を取得します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 LookupId As Long

Visual Basic (使用法)

Dim instance As Message
Dim value As Long

value = instance.LookupId

C#

public long LookupId { get; }

C++

public:
property long long LookupId {
    long long get ();
}

J#

/** @property */
public long get_LookupId ()

JScript

public function get LookupId
 () : long

プロパティ値
メッセージ キューによって生成され、そのメッセージが存在するキューに対して一意であるメッセージの参照識別子。

例外

例外の種類	条件
PlatformNotSupportedException	MSMQ 3.0 がインストールされていません。
InvalidOperationException	メッセージは送信されていません。このプロパティは、キューから取得したメッセージでだけ読み込むことができます。 または フィルタ処理されたメッセージ キューが、LookupId プロパティを無視します。

解説

LookupId プロパティは、メッセージの参照識別子に対する読み取り専用アクセスを提供します。参照識別子は、メッセージ キューによって生成され、メッセージがキューに挿入されたときに各メッセージに割り当てられる 64 ビットの識別子で、MSMQ 3.0 で導入されました。参照識別子は、メッセージの送信時に生成されるメッセージ ID とは異なります。

メッセージ キューは、アプリケーションによって生成される送信先キュー、管理キュー、レポート キュー、およびシステムによって生成されるジャーナル キュー、配信不能キュー、コネクタ キュー、送信キューなど、あらゆるキューに挿入されるすべてのメッセージについて、参照識別子を生成します。つまり、送信元アプリケーションから送信されるメッセージと、メッセージ キューから送信されるメッセージの両方が対象になります。参照識別子は、キューに対して一意であり、そのキュー以外では無効です。

メッセージが複数の送信先キューに送信される場合、またはメッセージのコピーがコンピュータの履歴かキュー ジャーナルに格納される場合、それぞれのキューへの挿入時に、メッセージの各コピーに独自の参照識別子が作成されます。

LookupId プロパティは、キューから取得したメッセージでだけ読み込むことができます。

参照識別子は、キュー内の特定のメッセージの読み取りに使用されます。メッセージの参照識別子が判明すると、受信側アプリケーションは、PeekByLookupId 関数または ReceiveByLookupId 関数を呼び出して、直接そのメッセージに移動し、ピークするか、キューから取得します。この点は、キューの先頭で開始し、キューの最後に移動する必要があるカーソルとは異なります。

キュー内のメッセージの参照識別子の取得は、アプリケーションで行います。参照識別子を取得する方法の 1 つは、送信先キューに、各メッセージの識別子がキューに挿入されたときにそれらをキャッシュするコンポーネントを起動するトリガを作成する方法です。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
PeekByLookupId
ReceiveByLookupId