MessageQueue.PeekByLookupId Metoda

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Zavedeno v MSMQ 3.0. Zobrazí náhled na konkrétní zprávu z fronty. Zpráva může být určena vyhledávacím identifikátorem nebo jeho umístěním na začátku nebo na konci fronty.

Přetížení

PeekByLookupId(Int64)	Zavedeno v MSMQ 3.0. Nahlédne do zprávy, která odpovídá danému identifikátoru vyhledávání z neakční fronty.
PeekByLookupId(MessageLookupAction, Int64)	Zavedeno v MSMQ 3.0. Zobrazí náhled na konkrétní zprávu z fronty. Zpráva může být určena vyhledávacím identifikátorem nebo jeho umístěním na začátku nebo na konci fronty.

PeekByLookupId(Int64)

Zavedeno v MSMQ 3.0. Nahlédne do zprávy, která odpovídá danému identifikátoru vyhledávání z neakční fronty.

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

Parametry

lookupId

Int64

Zpráva LookupId , na kterou se chcete podívat.

Návraty

Message

LookupId Jehož Message vlastnost odpovídá parametru lookupId předaného v.

Výjimky

PlatformNotSupportedException

MSMQ 3.0 není nainstalován.

InvalidOperationException

Zpráva se zadaným lookupId parametrem nebyla nalezena.

MessageQueueException

Při přístupu k metodě služby Řízení front zpráv došlo k chybě.

Poznámky

Tuto metodu použijte ke čtení zprávy se známým identifikátorem vyhledávání, aniž byste ji odebrali z fronty. Tato metoda vyvolá výjimku okamžitě, pokud zpráva není ve frontě.

Vlastnost LookupId zprávy je jedinečná pro frontu, ve které se zpráva nachází, takže ve frontě bude maximálně jedna zpráva, která odpovídá danému lookupId parametru.

Pokud chcete přečíst zprávu se zadaným identifikátorem vyhledávání a odebrat ji z fronty, použijte metodu ReceiveByLookupId .

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	K dispozici.
Místní počítač	Yes
Název místního počítače a přímého formátu	Yes
Vzdálený počítač	No
Název vzdáleného počítače a přímého formátu	Yes

Viz také

• LookupId
• ReceiveByLookupId

PeekByLookupId(MessageLookupAction, Int64)

Zavedeno v MSMQ 3.0. Zobrazí náhled na konkrétní zprávu z fronty. Zpráva může být určena vyhledávacím identifikátorem nebo jeho umístěním na začátku nebo na konci fronty.

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

Parametry

action

MessageLookupAction

Jedna z MessageLookupAction hodnot, která určuje, jak se zpráva čte ve frontě. Určete jednu z následujících možností:

MessageLookupAction.Current: Nahlédne na zprávu určenou nástrojem lookupId.

MessageLookupAction.Next: Zobrazí náhled zprávy za zprávou určenou nástrojem lookupId.

MessageLookupAction.Previous: Nahlédne do zprávy, která předchází zprávě zadané pomocí lookupId.

MessageLookupAction.First: Zobrazí náhled první zprávy ve frontě. Parametr lookupId musí být nastavený na hodnotu 0.

MessageLookupAction.Last: Zobrazí náhled poslední zprávy ve frontě. Parametr lookupId musí být nastavený na hodnotu 0.

lookupId

Int64

Zpráva LookupId , na kterou se má zobrazit, nebo 0. Hodnota 0 se používá při přístupu k první nebo poslední zprávě ve frontě.

Návraty

Message

action Zadané Message parametry a lookupId předanými v.

Výjimky

PlatformNotSupportedException

MSMQ 3.0 není nainstalován.

InvalidOperationException

Zpráva se zadaným lookupId parametrem nebyla nalezena.

MessageQueueException

Při přístupu k metodě služby Řízení front zpráv došlo k chybě.

InvalidEnumArgumentException

Parametr action není jedním ze MessageLookupAction členů.

Poznámky

Tuto metodu použijte ke čtení zprávy se známým identifikátorem vyhledávání, aniž byste ji odebrali z fronty. Tato metoda vyvolá výjimku okamžitě, pokud zpráva není ve frontě.

Vlastnost LookupId zprávy je jedinečná pro frontu, ve které se zpráva nachází, takže ve frontě bude maximálně jedna zpráva, která odpovídá danému lookupId parametru.

Pokud chcete přečíst zprávu se zadaným identifikátorem a odebrat ji z fronty, použijte metodu ReceiveByLookupId .

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	K dispozici.
Místní počítač	Yes
Název místního počítače a přímého formátu	Yes
Vzdálený počítač	No
Název vzdáleného počítače a přímého formátu	Yes

Viz také

• LookupId
• ReceiveByLookupId