Message.LookupId Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Eingeführt in MSMQ 3.0. Ruft den Suchbezeichner der Meldung ab.

public:
 property long LookupId { long get(); };

public long LookupId { get; }

member this.LookupId : int64

Public ReadOnly Property LookupId As Long

Eigenschaftswert

Int64

Der von Message Queuing generierte Suchbezeichner der Meldung ist für die Warteschlange eindeutig, in der sich die Meldung befindet.

Ausnahmen

PlatformNotSupportedException

MSMQ 3.0 ist nicht installiert.

InvalidOperationException

Die Meldung wurde nicht gesendet. Diese Eigenschaft kann nur bei Meldungen gelesen werden, die aus einer Warteschlange abgerufen wurden.

- oder -

Die LookupId-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

Hinweise

Die LookupId -Eigenschaft bietet schreibgeschützten Zugriff auf den Nachschlagebezeichner einer Nachricht. Der in MSMQ 3.0 eingeführte Nachschlagebezeichner ist ein 64-Bit-Bezeichner, der von Message Queuing generiert und jeder Nachricht zugewiesen wird, wenn die Nachricht in der Warteschlange platziert wird. Der Nachschlagebezeichner ist nicht identisch mit dem Nachrichtenbezeichner, der beim Senden der Nachricht generiert wird.

Message Queuing generiert einen Nachschlagebezeichner für alle Nachrichten, die in einer beliebigen Warteschlange platziert werden, einschließlich von der Anwendung generierten Ziel-, Verwaltungs- und Berichtswarteschlangen sowie vom System generierten Journal-, Unzustellbaren, Connector- und ausgehenden Warteschlangen. Anders ausgedrückt: Dies umfasst sowohl Nachrichten, die vom Senden von Anwendungen als auch von Message Queuing gesendet werden. Der Nachschlagebezeichner ist für die Warteschlange eindeutig und hat außerhalb der Warteschlange keine Bedeutung.

Wenn eine Nachricht an mehrere Zielwarteschlangen gesendet wird oder eine Kopie einer Nachricht in einem Computerjournal oder Warteschlangenjournal gespeichert wird, verfügt jede Kopie der Nachricht über einen eigenen Nachschlagebezeichner, wenn sie in ihrer jeweiligen Warteschlange platziert wird.

Die LookupId -Eigenschaft kann nur für Nachrichten gelesen werden, die aus einer Warteschlange abgerufen werden.

Ein Nachschlagebezeichner wird verwendet, um eine bestimmte Nachricht in der Warteschlange zu lesen. Sobald der Nachschlagebezeichner einer Nachricht bekannt ist, kann die empfangende Anwendung die PeekByLookupId - oder ReceiveByLookupId -Funktion aufrufen, um direkt zu dieser Nachricht zu wechseln und sie anzuzeigen oder aus der Warteschlange abzurufen, im Gegensatz zu Cursorn, die an der Vorderseite der Warteschlange beginnen und zum Ende der Warteschlange navigieren müssen.

Das Abrufen der Nachschlagebezeichner der Nachrichten in der Warteschlange liegt in der Verantwortung der Anwendung. Eine mögliche Möglichkeit zum Abrufen der Nachschlagebezeichner besteht darin, einen Trigger für die Zielwarteschlange zu erstellen, der eine Komponente aufruft, die die Bezeichner jeder Nachricht zwischenspeichert, während sie in der Warteschlange platziert werden.

Weitere Informationen

• PeekByLookupId
• ReceiveByLookupId