MessageQueue.PeekByLookupId Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Geïntroduceerd in MSMQ 3.0. Bekijkt een specifiek bericht uit de wachtrij. Het bericht kan worden opgegeven door een opzoek-id of door de positie ervan aan de voorkant of het einde van de wachtrij.
Overloads
| Name | Description |
|---|---|
| PeekByLookupId(Int64) |
Geïntroduceerd in MSMQ 3.0. Bekijk het bericht dat overeenkomt met de opgegeven opzoek-id uit een niet-transactionele wachtrij. |
| PeekByLookupId(MessageLookupAction, Int64) |
Geïntroduceerd in MSMQ 3.0. Bekijkt een specifiek bericht uit de wachtrij. Het bericht kan worden opgegeven door een opzoek-id of door de positie ervan aan de voorkant of het einde van de wachtrij. |
PeekByLookupId(Int64)
Geïntroduceerd in MSMQ 3.0. Bekijk het bericht dat overeenkomt met de opgegeven opzoek-id uit een niet-transactionele wachtrij.
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 MessageParameters
Retouren
De Message eigenschap waarvan LookupId de eigenschap overeenkomt met de lookupId parameter die is doorgegeven.
Uitzonderingen
MSMQ 3.0 is niet geïnstalleerd.
Het bericht met de opgegeven lookupId kan niet worden gevonden.
Er is een fout opgetreden bij het openen van een Message Queuing-methode.
Opmerkingen
Gebruik deze methode om een bericht met een bekende opzoek-id te lezen zonder het uit de wachtrij te verwijderen. Met deze methode wordt onmiddellijk een uitzondering gegenereerd als het bericht zich niet in de wachtrij bevindt.
De LookupId eigenschap van een bericht is uniek voor de wachtrij waarin het bericht zich bevindt, dus er is maximaal één bericht in de wachtrij die overeenkomt met de opgegeven lookupId parameter.
Als u een bericht met een opgegeven opzoek-id wilt lezen en uit de wachtrij wilt verwijderen, gebruikt u de ReceiveByLookupId methode.
In de volgende tabel ziet u of deze methode beschikbaar is in verschillende werkgroepmodi.
| Werkgroepmodus | Available |
|---|---|
| Lokale computer | Ja |
| Naam van lokale computer en directe indeling | Ja |
| Externe computer | No |
| Naam van externe computer en directe indeling | Ja |
Zie ook
Van toepassing op
PeekByLookupId(MessageLookupAction, Int64)
Geïntroduceerd in MSMQ 3.0. Bekijkt een specifiek bericht uit de wachtrij. Het bericht kan worden opgegeven door een opzoek-id of door de positie ervan aan de voorkant of het einde van de wachtrij.
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 MessageParameters
- action
- MessageLookupAction
Een van de MessageLookupAction waarden die aangeven hoe het bericht in de wachtrij wordt gelezen. Geef een van de volgende opties op:
MessageLookupAction.Current: Bekijkt het bericht dat is opgegeven door lookupId.
MessageLookupAction.Next: Bekijk het bericht na het bericht dat is opgegeven door lookupId.
MessageLookupAction.Previous: Bekijkt het bericht dat voorafgaat aan het bericht dat is opgegeven door lookupId.
MessageLookupAction.First: bekijkt het eerste bericht in de wachtrij. De lookupId parameter moet worden ingesteld op 0.
MessageLookupAction.Last: bekijkt het laatste bericht in de wachtrij. De lookupId parameter moet worden ingesteld op 0.
- lookupId
- Int64
Het LookupId bericht dat u wilt bekijken of 0. 0 wordt gebruikt bij het openen van het eerste of laatste bericht in de wachtrij.
Retouren
De Message opgegeven door de action en lookupId parameters die zijn doorgegeven.
Uitzonderingen
MSMQ 3.0 is niet geïnstalleerd.
Het bericht met de opgegeven lookupId kan niet worden gevonden.
Er is een fout opgetreden bij het openen van een Message Queuing-methode.
De action parameter is geen van de MessageLookupAction leden.
Opmerkingen
Gebruik deze methode om een bericht met een bekende opzoek-id te lezen zonder het uit de wachtrij te verwijderen. Met deze methode wordt onmiddellijk een uitzondering gegenereerd als het bericht zich niet in de wachtrij bevindt.
De LookupId eigenschap van een bericht is uniek voor de wachtrij waarin het bericht zich bevindt, dus er is maximaal één bericht in de wachtrij die overeenkomt met de opgegeven lookupId parameter.
Als u een bericht met een opgegeven id wilt lezen en uit de wachtrij wilt verwijderen, gebruikt u de ReceiveByLookupId methode.
In de volgende tabel ziet u of deze methode beschikbaar is in verschillende werkgroepmodi.
| Werkgroepmodus | Available |
|---|---|
| Lokale computer | Ja |
| Naam van lokale computer en directe indeling | Ja |
| Externe computer | No |
| Naam van externe computer en directe indeling | Ja |