共用方式為


Message.LookupId 屬性

定義

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

public:
 property long LookupId { long get(); };
public long LookupId { get; }
member this.LookupId : int64
Public ReadOnly Property LookupId As Long

屬性值

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

例外狀況

未安裝 MSMQ 3.0。

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

-或-

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

備註

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

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

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

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

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

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

適用於

另請參閱