Message.LookupId Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zavedeno v MSMQ 3.0. Získá vyhledávací identifikátor zprávy.
public:
property long LookupId { long get(); };public long LookupId { get; }member this.LookupId : int64Public ReadOnly Property LookupId As LongHodnota vlastnosti
Vyhledávací identifikátor zprávy, který je generován službou Řízení front zpráv a je jedinečný pro frontu, ve které se zpráva nachází.
Výjimky
MSMQ 3.0 není nainstalován.
Zpráva nebyla odeslána. Tuto vlastnost lze číst pouze u zpráv načtených z fronty.
nebo
Fronta zpráv je filtrována tak, aby ignorovala LookupId vlastnost.
Poznámky
Tato LookupId vlastnost poskytuje přístup jen pro čtení k identifikátoru vyhledávání zprávy. Identifikátor vyhledávání, zavedený v MSMQ 3.0, je 64bitový identifikátor, který je generován službou Řízení front zpráv a přiřazen ke každé zprávě při umístění zprávy do fronty. Identifikátor vyhledávání není stejný jako identifikátor zprávy, který se vygeneruje při odeslání zprávy.
Služba Řízení front zpráv vygeneruje vyhledávací identifikátor pro všechny zprávy, které jsou umístěné v libovolné frontě, včetně front generovaných aplikací, správy a front sestav, jakož i systémem generovaného deníku, nedoručených zpráv, konektoru a odchozích front. Jinými slovy, to zahrnuje jak zprávy odeslané odesíláním aplikací, tak službou Řízení front zpráv. Identifikátor vyhledávání je jedinečný pro frontu a nemá žádný význam mimo frontu.
Pokud je zpráva odeslána do několika cílových front nebo pokud je kopie zprávy uložena v deníku počítače nebo deníku fronty, každá kopie zprávy bude mít při umístění do příslušné fronty svůj vlastní identifikátor vyhledávání.
Vlastnost LookupId lze číst pouze u zpráv načtených z fronty.
Identifikátor vyhledávání se používá ke čtení konkrétní zprávy ve frontě. Jakmile je identifikátor vyhledávání zprávy známý, může přijímající aplikace volat PeekByLookupId nebo ReceiveByLookupId funkci, která přejde přímo na tuto zprávu, a načte ji nebo načte z fronty, na rozdíl od kurzorů, které musí začínat na přední straně fronty a přejít na konec fronty,
Získání identifikátorů vyhledávání zpráv ve frontě je zodpovědností aplikace. Jedním z možných způsobů, jak získat identifikátory vyhledávání, je vytvořit aktivační událost pro cílovou frontu, která vyvolá komponentu, která ukládá identifikátory každé zprávy do mezipaměti při jejich umístění do fronty.
