MessageQueue.PeekByLookupId Metoda

  • Reference

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é

Platí pro

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é

Platí pro