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 參數的 Message 的 LookupId。
例外狀況
未安裝 MSMQ 3.0。
找不到具有指定 lookupId 的訊息。
存取訊息佇列方法時發生錯誤。
備註
使用此方法可讀取具有已知查閱標識符的訊息，而不需從佇列中移除它。 如果訊息不在佇列中，這個方法會立即擲回例外狀況。
訊息 LookupId 的 屬性對訊息所在的佇列而言是唯一的，因此佇列中最多會有一個符合指定 lookupId 參數的訊息。
若要讀取具有指定查閱標識碼的訊息，並將它從佇列中移除，請使用 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 值，指定如何在佇列中讀取訊息。 請指定下列其中一個選項：
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 成員。
備註
使用此方法可讀取具有已知查閱標識符的訊息，而不需從佇列中移除它。 如果訊息不在佇列中，這個方法會立即擲回例外狀況。
訊息 LookupId 的 屬性對訊息所在的佇列而言是唯一的，因此佇列中最多會有一個符合指定 lookupId 參數的訊息。
若要讀取具有指定標識碼的訊息，並將它從佇列中移除，請使用 ReceiveByLookupId 方法。
下表顯示這個方法是否可在各種工作組模式中使用。
| 工作組模式 | 可用 |
|---|---|
| 本機電腦 | 是 |
| 本機計算機和直接格式名稱 | 是 |
| 遠端電腦 | 否 |
| 遠端電腦和直接格式名稱 | 是 |
