Message.LookupId Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Wprowadzono w programie MSMQ 3.0. Pobiera identyfikator odnośnika komunikatu.

public:
 property long LookupId { long get(); };
public long LookupId { get; }
member this.LookupId : int64
Public ReadOnly Property LookupId As Long

Wartość właściwości

Int64

Identyfikator wyszukiwania komunikatu, który jest generowany przez kolejkę komunikatów i jest unikatowy dla kolejki, w której znajduje się komunikat.

Wyjątki

PlatformNotSupportedException

Program MSMQ 3.0 nie jest zainstalowany.

InvalidOperationException

Wiadomość nie została wysłana. Ta właściwość może być odczytywana tylko w komunikatach pobranych z kolejki.

-lub-

Kolejka komunikatów jest filtrowana w celu zignorowania LookupId właściwości.

Uwagi

Właściwość LookupId zapewnia dostęp tylko do odczytu do identyfikatora odnośnika komunikatu. Identyfikator odnośnika wprowadzony w msMQ 3.0 jest identyfikatorem 64-bitowym generowanym przez kolejkowanie komunikatów i przypisanym do każdego komunikatu po umieszczeniu komunikatu w kolejce. Identyfikator odnośnika nie jest taki sam jak identyfikator komunikatu generowany podczas wysyłania komunikatu.

Kolejkowanie komunikatów generuje identyfikator wyszukiwania dla wszystkich komunikatów umieszczonych w dowolnej kolejce, w tym lokalizacji docelowej wygenerowanej przez aplikację, administracji i kolejek raportów, a także dzienników generowanych przez system, utraconych wiadomości, łączników i kolejek wychodzących. Innymi słowy, obejmuje to zarówno komunikaty wysyłane przez wysyłanie aplikacji, jak i kolejkowanie komunikatów. Identyfikator odnośnika jest unikatowy dla kolejki i nie ma znaczenia poza kolejką.

Jeśli komunikat jest wysyłany do kilku kolejek docelowych lub jeśli kopia komunikatu jest przechowywana w dzienniku komputera lub dzienniku kolejki, każda kopia komunikatu będzie miała własny identyfikator odnośnika, gdy zostanie umieszczony w odpowiedniej kolejce.

Właściwość LookupId może być odczytywana tylko w komunikatach pobranych z kolejki.

Identyfikator odnośnika służy do odczytywania określonego komunikatu w kolejce. Gdy identyfikator wyszukiwania komunikatu jest znany, aplikacja odbierający może wywołać PeekByLookupId funkcję lub ReceiveByLookupId , aby przejść bezpośrednio do tego komunikatu i sprawdzić lub pobrać go z kolejki, w przeciwieństwie do kursorów, które muszą zaczynać się przed kolejką i przechodzić w kierunku końca kolejki,

Uzyskanie identyfikatorów odnośników komunikatów w kolejce jest obowiązkiem aplikacji. Jednym z możliwych sposobów uzyskania identyfikatorów odnośników jest utworzenie wyzwalacza dla kolejki docelowej, która wywołuje składnik, który buforuje identyfikatory każdego komunikatu podczas umieszczania ich w kolejce.

Dotyczy

Zobacz też