Message.LookupId Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 da propriedade
O identificador de pesquisa da mensagem, que é gerado pelo Enfileiramento de Mensagens e é exclusivo da fila em que a mensagem reside.
Exceções
O MSMQ 3.0 não está instalado.
A mensagem não foi enviada. Essa propriedade só pode ser lida em mensagens recuperadas de uma fila.
- ou - A fila de mensagens é filtrada para ignorar a propriedade LookupId.
Comentários
A LookupId propriedade fornece acesso somente leitura ao identificador de pesquisa de uma mensagem. O identificador de pesquisa, introduzido no MSMQ 3.0, é um identificador de 64 bits gerado pelo Enfileiramento 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.
O Enfileiramento de Mensagens gera um identificador de pesquisa para todas as mensagens que são colocadas em qualquer fila, incluindo filas de destino, administração e relatório geradas pelo aplicativo, bem como diário gerado pelo sistema, mensagens mortas, conectores e filas de saída. Em outras palavras, isso inclui mensagens enviadas enviando aplicativos e por Enfileiramento de Mensagens. O identificador de pesquisa é exclusivo para a fila e não tem significado fora da fila.
Se uma mensagem for enviada para várias filas de destino ou se uma cópia de uma mensagem for armazenada em um diário de computador ou diário de fila, cada cópia da mensagem terá seu próprio identificador de pesquisa quando ela for colocada em sua respectiva fila.
A LookupId propriedade só pode ser lida em mensagens recuperadas de uma fila.
Um identificador de pesquisa é usado para ler uma mensagem específica na fila. Depois que o identificador de pesquisa de uma mensagem for conhecido, o aplicativo receptor poderá chamar a PeekByLookupId ReceiveByLookupId ou a função para ir diretamente para essa mensagem e espiá-la ou recuperá-la da fila, ao contrário dos cursores que devem começar na frente da fila e navegar até o final da fila,
Obter os identificadores de pesquisa das mensagens na fila é responsabilidade do aplicativo. Uma maneira 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 eles são colocados na fila.