Message.LookupId Vlastnost

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

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 : int64

Public ReadOnly Property LookupId As Long

Hodnota vlastnosti

Int64

Identifikátor vyhledávání 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

PlatformNotSupportedException

MSMQ 3.0 není nainstalován.

InvalidOperationException

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

Vlastnost LookupId 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ě, když je zpráva umístěna ve frontě. 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 identifikátor vyhledávání pro všechny zprávy, které jsou umístěny v libovolné frontě, včetně cílových front generovaných aplikací, front pro správu a sestav, jakož i systémově generovaných deníků, nedoručených zpráv, konektorů a odchozích front. Jinými slovy, to zahrnuje jak zprávy odesílané prostřednictvím odesílaných aplikací, tak služby Řízení front zpráv. Identifikátor vyhledávání je pro frontu jedinečný a mimo frontu nemá žádný význam.

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, bude mít každá kopie zprávy při umístění do příslušné fronty svůj vlastní identifikátor vyhledávání.

Vlastnost LookupId lze číst jenom 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ávací zprávy známý, může přijímající aplikace volat PeekByLookupId funkci nebo ReceiveByLookupId , která přejde přímo na tuto zprávu a nahlédne na ni nebo ji načte z fronty, na rozdíl od kurzorů, které musí začínat na začátku fronty a procházet směrem ke konci fronty.

Za získání identifikátorů vyhledávání zpráv ve frontě zodpovídá 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 tak, jak jsou umístěny ve frontě.

Viz také

• PeekByLookupId
• ReceiveByLookupId