MessageQueue.PeekByLookupId Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Introducerades i MSMQ 3.0. Tittar på ett specifikt meddelande från kön. Meddelandet kan anges av en uppslagsidentifierare eller av dess position i köns fram- eller ände.
Överlagringar
| Name | Description |
|---|---|
| PeekByLookupId(Int64) |
Introducerades i MSMQ 3.0. Tittar på meddelandet som matchar den angivna uppslagsidentifieraren från en icke-transaktionell kö. |
| PeekByLookupId(MessageLookupAction, Int64) |
Introducerades i MSMQ 3.0. Tittar på ett specifikt meddelande från kön. Meddelandet kan anges av en uppslagsidentifierare eller av dess position i köns fram- eller ände. |
PeekByLookupId(Int64)
Introducerades i MSMQ 3.0. Tittar på meddelandet som matchar den angivna uppslagsidentifieraren från en icke-transaktionell kö.
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 MessageParametrar
Returer
Vars MessageLookupId egenskap matchar parametern lookupId som skickades in.
Undantag
MSMQ 3.0 är inte installerat.
Det gick inte att hitta meddelandet med angivet lookupId .
Ett fel uppstod vid åtkomst till en Message Queuing-metod.
Kommentarer
Använd den här metoden för att läsa ett meddelande med en känd uppslagsidentifierare utan att ta bort det från kön. Den här metoden utlöser ett undantag omedelbart om meddelandet inte finns i kön.
Egenskapen LookupId för ett meddelande är unik för kön där meddelandet finns, så det finns högst ett meddelande i kön som matchar den angivna lookupId parametern.
Om du vill läsa ett meddelande med en angiven uppslagsidentifierare och ta bort det från kön använder du ReceiveByLookupId metoden .
I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.
| Arbetsgruppsläge | Tillgängligt |
|---|---|
| Lokal dator | Yes |
| Namn på lokal dator och direktformat | Yes |
| Fjärrdator | No |
| Namn på fjärrdator och direktformat | Yes |
Se även
Gäller för
PeekByLookupId(MessageLookupAction, Int64)
Introducerades i MSMQ 3.0. Tittar på ett specifikt meddelande från kön. Meddelandet kan anges av en uppslagsidentifierare eller av dess position i köns fram- eller ände.
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 MessageParametrar
- action
- MessageLookupAction
Ett av MessageLookupAction värdena som anger hur meddelandet ska läsas i kön. Ange något av följande:
MessageLookupAction.Current: Tittar på meddelandet som anges av lookupId.
MessageLookupAction.Next: Tittar på meddelandet efter meddelandet som anges av lookupId.
MessageLookupAction.Previous: Tittar på meddelandet före meddelandet som anges av lookupId.
MessageLookupAction.First: Tittar på det första meddelandet i kön. Parametern lookupId måste vara inställd på 0.
MessageLookupAction.Last: Tittar på det sista meddelandet i kön. Parametern lookupId måste vara inställd på 0.
- lookupId
- Int64
Meddelandet LookupId som du vill titta på, eller 0. 0 används vid åtkomst till det första eller sista meddelandet i kön.
Returer
Angivet Message av parametrarna action och lookupId som skickades in.
Undantag
MSMQ 3.0 är inte installerat.
Det gick inte att hitta meddelandet med angivet lookupId .
Ett fel uppstod vid åtkomst till en Message Queuing-metod.
Parametern action är inte en av MessageLookupAction medlemmarna.
Kommentarer
Använd den här metoden för att läsa ett meddelande med en känd uppslagsidentifierare utan att ta bort det från kön. Den här metoden utlöser ett undantag omedelbart om meddelandet inte finns i kön.
Egenskapen LookupId för ett meddelande är unik för kön där meddelandet finns, så det finns högst ett meddelande i kön som matchar den angivna lookupId parametern.
Om du vill läsa ett meddelande med en angiven identifierare och ta bort det från kön använder du ReceiveByLookupId metoden .
I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.
| Arbetsgruppsläge | Tillgängligt |
|---|---|
| Lokal dator | Yes |
| Namn på lokal dator och direktformat | Yes |
| Fjärrdator | No |
| Namn på fjärrdator och direktformat | Yes |
