Message.LookupId Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wprowadzono w programie MSMQ 3.0. Pobiera identyfikator odnośnika komunikatu.
public:
property long LookupId { long get(); };public long LookupId { get; }member this.LookupId : int64Public ReadOnly Property LookupId As LongWartość właściwości
Identyfikator wyszukiwania komunikatu, który jest generowany przez kolejkę komunikatów i jest unikatowy dla kolejki, w której znajduje się komunikat.
Wyjątki
Program MSMQ 3.0 nie jest zainstalowany.
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.
