MessageQueue.PeekByLookupId Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zavedeno v MSMQ 3.0. Zobrazí se náhled konkrétní zprávy z fronty. Zprávu lze zadat pomocí identifikátoru vyhledávání nebo podle jeho pozice na přední nebo koncové straně fronty.
Přetížení
| Name | Description |
|---|---|
| PeekByLookupId(Int64) |
Zavedeno v MSMQ 3.0. Zobrazí náhled zprávy, která odpovídá danému vyhledávacímu identifikátoru z neaktuální fronty. |
| PeekByLookupId(MessageLookupAction, Int64) |
Zavedeno v MSMQ 3.0. Zobrazí se náhled konkrétní zprávy z fronty. Zprávu lze zadat pomocí identifikátoru vyhledávání nebo podle jeho pozice na přední nebo koncové straně fronty. |
PeekByLookupId(Int64)
Zavedeno v MSMQ 3.0. Zobrazí náhled zprávy, která odpovídá danému vyhledávacímu identifikátoru z neaktuální fronty.
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 MessageParametry
Návraty
LookupId Jehož Message vlastnost odpovídá parametru lookupId předaného.
Výjimky
MSMQ 3.0 není nainstalován.
Zpráva se zadanou lookupId zprávou nebyla nalezena.
Při přístupu k metodě řízení front zpráv došlo k chybě.
Poznámky
Tuto metodu použijte ke čtení zprávy se známým vyhledávacím identifikátorem, aniž byste ji odebrali z fronty. Tato metoda vyvolá výjimku okamžitě, pokud zpráva není ve frontě.
LookupId Vlastnost 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č | Ano |
| Název místního počítače a přímého formátu | Ano |
| Vzdálený počítač | Ne |
| Název vzdáleného počítače a přímého formátu | Ano |
Viz také
Platí pro
PeekByLookupId(MessageLookupAction, Int64)
Zavedeno v MSMQ 3.0. Zobrazí se náhled konkrétní zprávy z fronty. Zprávu lze zadat pomocí identifikátoru vyhledávání nebo podle jeho pozice na přední nebo koncové straně 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.MessagePublic Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As MessageParametry
- action
- MessageLookupAction
Jedna z MessageLookupAction hodnot určující, jak se zpráva čte ve frontě. Zadejte jednu z následujících možností:
MessageLookupAction.Current: Náhledy na zprávu určenou uživatelem lookupId.
MessageLookupAction.Next: Náhled zprávy následuje za zprávou určenou uživatelem lookupId.
MessageLookupAction.Previous: Zobrazí se náhled zprávy před zprávou určenou uživatelem lookupId.
MessageLookupAction.First: Zobrazí se první zpráva ve frontě. Parametr lookupId musí být nastaven na hodnotu 0.
MessageLookupAction.Last: Zobrazí se 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á podívat, nebo na 0. 0 se používá při přístupu k první nebo poslední zprávě ve frontě.
Návraty
Zadané Message parametry action a lookupId parametry předané.
Výjimky
MSMQ 3.0 není nainstalován.
Zpráva se zadanou lookupId zprávou nebyla nalezena.
Při přístupu k metodě řízení front zpráv došlo k chybě.
Parametr action není jedním z MessageLookupAction členů.
Poznámky
Tuto metodu použijte ke čtení zprávy se známým vyhledávacím identifikátorem, aniž byste ji odebrali z fronty. Tato metoda vyvolá výjimku okamžitě, pokud zpráva není ve frontě.
LookupId Vlastnost 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č | Ano |
| Název místního počítače a přímého formátu | Ano |
| Vzdálený počítač | Ne |
| Název vzdáleného počítače a přímého formátu | Ano |
