Message.LookupId Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Introduzido no MSMQ 3.0. Obtém o identificador de pesquisa da mensagem.
public:
property long LookupId { long get(); };public long LookupId { get; }member this.LookupId : int64Public ReadOnly Property LookupId As LongValor de Propriedade
O identificador de pesquisa da mensagem, que é gerado pela Fila de Mensagens e é único para a fila onde a mensagem reside.
Exceções
O MSMQ 3.0 não está instalado.
A mensagem não foi enviada. Esta propriedade só pode ser lida em mensagens recuperadas de uma fila.
-ou-
A fila de mensagens é filtrada para ignorar a LookupId propriedade.
Observações
A LookupId propriedade fornece acesso apenas de leitura ao identificador de pesquisa de uma mensagem. O identificador de consulta, introduzido no MSMQ 3.0, é um identificador de 64 bits gerado pela Fila de Mensagens e atribuído a cada mensagem quando a mensagem é colocada na fila. O identificador de pesquisa não é o mesmo que o identificador de mensagem gerado quando a mensagem é enviada.
A Fila de Mensagens gera um identificador de pesquisa para todas as mensagens colocadas em qualquer fila, incluindo filas de destino, administração e relatórios geradas pela aplicação, bem como filas de journal, dead-letter, connector e de saída geradas pelo sistema. Ou seja, isto inclui tanto mensagens enviadas por aplicações enviadoras como por Fila de Mensagens. O identificador de pesquisa é único para a fila e não tem significado fora dela.
Se uma mensagem for enviada para várias filas de destino, ou se uma cópia de uma mensagem for armazenada num diário de computador ou diário de fila, cada cópia da mensagem terá o seu próprio identificador de consulta quando for colocada na respetiva fila.
A LookupId propriedade só pode ser lida em mensagens recuperadas de uma fila.
Um identificador de consulta é usado para ler uma mensagem específica na fila. Uma vez conhecido o identificador de consulta de uma mensagem, a aplicação recetora pode chamar a PeekByLookupId função ou ReceiveByLookupId para ir diretamente a essa mensagem e espreitá-la ou recuperá-la da fila, ao contrário dos cursores que devem começar no início da fila e navegar até ao fim da fila,
Obter os identificadores de pesquisa das mensagens na fila é responsabilidade da aplicação. Uma forma possível de obter os identificadores de pesquisa é criar um gatilho para a fila de destino que invoca um componente que armazena em cache os identificadores de cada mensagem à medida que são colocados na fila.
