MessageQueue.PeekByLookupId 方法

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

在 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.Message

Public Function PeekByLookupId (lookupId As Long) As Message

參數

lookupId

Int64

要窺視之訊息的 LookupId。

傳回

Message

傳入符合 lookupId 參數的 Message 的 LookupId。

例外狀況

PlatformNotSupportedException

未安裝 MSMQ 3.0。

InvalidOperationException

找不到具有指定 lookupId 的訊息。

MessageQueueException

存取訊息佇列方法時發生錯誤。

備註

使用此方法可讀取具有已知查閱標識符的訊息，而不需從佇列中移除它。 如果訊息不在佇列中，這個方法會立即擲回例外狀況。

訊息 LookupId 的 屬性對訊息所在的佇列而言是唯一的，因此佇列中最多會有一個符合指定 lookupId 參數的訊息。

若要讀取具有指定查閱標識碼的訊息，並將它從佇列中移除，請使用 ReceiveByLookupId 方法。

下表顯示這個方法是否可在各種工作組模式中使用。

工作組模式	可用
本機電腦	是
本機計算機和直接格式名稱	是
遠端電腦	否
遠端電腦和直接格式名稱	是

另請參閱

• 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.Message

Public 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。

lookupId

Int64

要窺視之訊息的 LookupId，或者為 0。 存取佇列中第一則或最後一則訊息時會使用 0。

傳回

Message

傳入之 action 和 lookupId 參數所指定的 Message。

例外狀況

PlatformNotSupportedException

未安裝 MSMQ 3.0。

InvalidOperationException

找不到具有指定 lookupId 的訊息。

MessageQueueException

存取訊息佇列方法時發生錯誤。

InvalidEnumArgumentException

action 參數不是其中一個 MessageLookupAction 成員。

備註

使用此方法可讀取具有已知查閱標識符的訊息，而不需從佇列中移除它。 如果訊息不在佇列中，這個方法會立即擲回例外狀況。

訊息 LookupId 的 屬性對訊息所在的佇列而言是唯一的，因此佇列中最多會有一個符合指定 lookupId 參數的訊息。

若要讀取具有指定標識碼的訊息，並將它從佇列中移除，請使用 ReceiveByLookupId 方法。

下表顯示這個方法是否可在各種工作組模式中使用。

工作組模式	可用
本機電腦	是
本機計算機和直接格式名稱	是
遠端電腦	否
遠端電腦和直接格式名稱	是

另請參閱

• LookupId
• ReceiveByLookupId