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 Suchbezeichner 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 mit dem Nachrichtenbezeichner identisch, der beim Senden der Nachricht generiert wird.

Message Queuing generiert einen Suchbezeichner für alle Nachrichten, die in einer beliebigen Warteschlange platziert werden, einschließlich von der Anwendung generierten Ziel-, Verwaltungs- und Berichtswarteschlangen sowie systemgenerierten Journal-, Dead-Letter-, Connector- und ausgehenden Warteschlangen. Mit anderen Worten, dies umfasst sowohl Nachrichten, die vom Senden von Anwendungen als auch von Message Queuing gesendet werden. Der Suchbezeichner 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 Computer- oder Warteschlangenjournal gespeichert wird, verfügt jede Kopie der Nachricht über einen eigenen Suchbezeichner, 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 Suchbezeichner wird verwendet, um eine bestimmte Nachricht in der Warteschlange zu lesen. Sobald der Nachschlagebezeichner einer Nachricht bekannt ist, kann die empfangende Anwendung die PeekByLookupId -Funktion oder ReceiveByLookupId aufrufen, um direkt zu dieser Nachricht zu wechseln und sie in der Warteschlange 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 Suchbezeichner 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