Message.LookupId 屬性

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

在 MSMQ 3.0 中介紹。 取得訊息的查詢識別項。

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

public long LookupId { get; }

member this.LookupId : int64

Public ReadOnly Property LookupId As Long

屬性值

Int64

訊息的查詢識別項，由訊息佇列產生，且對於訊息所在佇列是唯一的。

例外狀況

PlatformNotSupportedException

未安裝 MSMQ 3.0。

InvalidOperationException

未傳送訊息。 這個屬性只能在從佇列擷取的訊息中讀取。

-或-

篩選訊息佇列以忽略 LookupId 屬性。

備註

屬性 LookupId 提供訊息查閱標識碼的唯讀存取權。 MSMQ 3.0 中引進的查閱標識碼是訊息佇列所產生的 64 位標識碼，並在訊息放在佇列中時指派給每個訊息。 查閱標識碼與傳送訊息時產生的訊息標識碼不同。

消息佇列會針對任何佇列中放置的所有訊息產生查閱標識碼，包括應用程式產生的目的地、系統管理及報表佇列，以及系統產生的日誌、寄不出的信件、連接器和傳出佇列。 換句話說，這包括透過傳送應用程式和消息佇列傳送的訊息。 查閱標識符對佇列而言是唯一的，而且在佇列之外沒有意義。

如果訊息傳送至數個目的地佇列，或訊息的複本儲存在計算機日誌或佇列日誌中，則訊息的每個複本都會在其個別佇列中時有自己的查閱標識碼。

LookupId屬性只能在從佇列擷取的訊息上讀取。

查閱標識碼可用來讀取佇列中的特定訊息。 一旦知道訊息的查閱標識符之後，接收應用程式就可以呼叫 PeekByLookupId 或 ReceiveByLookupId 函式直接移至該訊息，並從佇列中查看或擷取它，不同於必須在佇列前端開始的數據指標，並巡覽至佇列結尾，

取得佇列中訊息的查閱標識碼是應用程式的責任。 取得查閱標識碼的其中一個可能方式，就是建立目的地佇列的觸發程式，以叫用在佇列中時快取每個訊息的標識碼的元件。

另請參閱

• PeekByLookupId
• ReceiveByLookupId