MessageQueue.PeekByLookupId Methode

Definition

Eingeführt in MSMQ 3.0. Sieht eine bestimmte Meldung in der Warteschlange ein. Die Meldung kann anhand eines Suchbezeichners oder anhand der Position am Anfang oder am Ende der Warteschlange angegeben werden.

Überlädt

PeekByLookupId(Int64)

Eingeführt in MSMQ 3.0. Sieht die Meldung ein, die dem angegebenen Suchbezeichner in einer nicht transaktionalen Warteschlange entspricht.

PeekByLookupId(MessageLookupAction, Int64)

Eingeführt in MSMQ 3.0. Sieht eine bestimmte Meldung in der Warteschlange ein. Die Meldung kann anhand eines Suchbezeichners oder anhand der Position am Anfang oder am Ende der Warteschlange angegeben werden.

PeekByLookupId(Int64)

Eingeführt in MSMQ 3.0. Sieht die Meldung ein, die dem angegebenen Suchbezeichner in einer nicht transaktionalen Warteschlange entspricht.

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

Parameter

lookupId
Int64

Die LookupId der einzusehenden Meldung.

Gibt zurück

Die Message, deren LookupId-Eigenschaft dem übergebenen lookupId-Parameter entspricht.

Ausnahmen

MSMQ 3.0 ist nicht installiert.

Die Meldung mit der angegebenen lookupId wurde nicht gefunden.

Fehler beim Zugriff auf eine Message Queuing-Methode.

Hinweise

Verwenden Sie diese Methode, um eine Nachricht mit einem bekannten Nachschlagebezeichner zu lesen, ohne sie aus der Warteschlange zu entfernen. Diese Methode löst sofort eine Ausnahme aus, wenn sich die Nachricht nicht in der Warteschlange befindet.

Die LookupId Eigenschaft einer Nachricht ist für die Warteschlange eindeutig, in der sich die Nachricht befindet. Daher befindet sich in der Warteschlange höchstens eine Nachricht, die dem angegebenen lookupId Parameter entspricht.

Verwenden Sie die -Methode, um eine Nachricht mit einem angegebenen Nachschlagebezeichner zu lesen und aus der ReceiveByLookupId Warteschlange zu entfernen.

Die folgende Tabelle zeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokalem Computer Ja
Name des lokalen Computers und des direkten Formats Ja
Remotecomputer Nein
Name des Remotecomputers und des direkten Formats Ja

Weitere Informationen

Gilt für:

PeekByLookupId(MessageLookupAction, Int64)

Eingeführt in MSMQ 3.0. Sieht eine bestimmte Meldung in der Warteschlange ein. Die Meldung kann anhand eines Suchbezeichners oder anhand der Position am Anfang oder am Ende der Warteschlange angegeben werden.

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

Parameter

action
MessageLookupAction

Einer der MessageLookupAction-Werte, der angibt, wie die Meldung in der Warteschlange gelesen wird. Geben Sie eine der folgenden Optionen an:

MessageLookupAction.Current: Sieht die durch die lookupId angegebene Meldung ein.

MessageLookupAction.Next: Sieht die Meldung ein, die auf die anhand der lookupId angegebene Meldung folgt.

MessageLookupAction.Previous: Sieht die Meldung ein, die der anhand der lookupId angegebenen Meldung vorausgeht.

MessageLookupAction.First: Sieht die erste Meldung in der Warteschlange ein. Der lookupId-Parameter muss auf 0 festgelegt werden.

MessageLookupAction.Last: Sieht die letzte Meldung in der Warteschlange ein. Der lookupId-Parameter muss auf 0 festgelegt werden.

lookupId
Int64

Die LookupId der einzusehenden Meldung, andernfalls 0 (null). 0 wird beim Zugreifen auf die erste oder letzte Meldung in die Warteschlange verwendet.

Gibt zurück

Die durch den übergebenen action-Parameter und lookupId-Parameter angegebene Message.

Ausnahmen

MSMQ 3.0 ist nicht installiert.

Die Meldung mit der angegebenen lookupId wurde nicht gefunden.

Fehler beim Zugriff auf eine Message Queuing-Methode.

Der action-Parameter ist keiner der MessageLookupAction-Member.

Hinweise

Verwenden Sie diese Methode, um eine Nachricht mit einem bekannten Nachschlagebezeichner zu lesen, ohne sie aus der Warteschlange zu entfernen. Diese Methode löst sofort eine Ausnahme aus, wenn sich die Nachricht nicht in der Warteschlange befindet.

Die LookupId Eigenschaft einer Nachricht ist für die Warteschlange eindeutig, in der sich die Nachricht befindet. Daher befindet sich in der Warteschlange höchstens eine Nachricht, die dem angegebenen lookupId Parameter entspricht.

Verwenden Sie die -Methode, um eine Nachricht mit einem angegebenen Bezeichner zu lesen und aus der ReceiveByLookupId Warteschlange zu entfernen.

Die folgende Tabelle zeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus Verfügbar
Lokalem Computer Ja
Name des lokalen Computers und des direkten Formats Ja
Remotecomputer Nein
Name des Remotecomputers und des direkten Formats Ja

Weitere Informationen

Gilt für: