MessageQueue.PeekByLookupId Método
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. Espia uma mensagem específica da fila. A mensagem pode ser especificada por um identificador de pesquisa ou pela sua posição no início ou no final da fila.
Sobrecargas
| PeekByLookupId(Int64) |
Introduzido no MSMQ 3.0. Espiada na mensagem que corresponde ao identificador de pesquisa especificado de uma fila não transacional. |
| PeekByLookupId(MessageLookupAction, Int64) |
Introduzido no MSMQ 3.0. Espia uma mensagem específica da fila. A mensagem pode ser especificada por um identificador de pesquisa ou pela sua posição no início ou no final da fila. |
PeekByLookupId(Int64)
Introduzido no MSMQ 3.0. Espiada na mensagem que corresponde ao identificador de pesquisa especificado de uma fila não transacional.
public:
System::Messaging::Message ^ PeekByLookupId(long lookupId);public System.Messaging.Message PeekByLookupId (long lookupId);member this.PeekByLookupId : int64 -> System.Messaging.MessagePublic Function PeekByLookupId (lookupId As Long) As MessageParâmetros
Retornos
O Message cuja propriedade LookupId corresponde ao parâmetro lookupId passado.
Exceções
O MSMQ 3.0 não está instalado.
Não foi possível localizar a mensagem com o lookupId especificado.
Erro ao acessar um método do serviço de Enfileiramento de Mensagens.
Comentários
Use esse método para ler uma mensagem com um identificador de pesquisa conhecido sem removê-la da fila. Esse método gerará uma exceção imediatamente se a mensagem não estiver na fila.
A LookupId propriedade de uma mensagem é exclusiva para a fila em que a mensagem reside, portanto, haverá no máximo uma mensagem na fila que corresponde ao parâmetro especificado lookupId .
Para ler uma mensagem com um identificador de pesquisa especificado e removê-la da fila, use o ReceiveByLookupId método.
A tabela a seguir mostra se esse método está disponível em vários modos de grupo de trabalho.
| Modo de grupo de trabalho | Disponível |
|---|---|
| Computador local | Yes |
| Nome do computador local e do formato direto | Yes |
| Computador remoto | Não |
| Nome do computador remoto e do formato direto | Yes |
Confira também
Aplica-se a
PeekByLookupId(MessageLookupAction, Int64)
Introduzido no MSMQ 3.0. Espia uma mensagem específica da fila. A mensagem pode ser especificada por um identificador de pesquisa ou pela sua posição no início ou no final da fila.
public:
System::Messaging::Message ^ PeekByLookupId(System::Messaging::MessageLookupAction action, long lookupId);public System.Messaging.Message PeekByLookupId (System.Messaging.MessageLookupAction action, long lookupId);member this.PeekByLookupId : System.Messaging.MessageLookupAction * int64 -> System.Messaging.MessagePublic Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As MessageParâmetros
- action
- MessageLookupAction
Um dos valores MessageLookupAction, especificando como a mensagem é lida na fila. Especifique um dos seguintes:
MessageLookupAction.Current: espia a mensagem especificada pelo lookupId.
MessageLookupAction.Next: espia a mensagem posterior à mensagem especificada pelo lookupId.
MessageLookupAction.Previous: espia a mensagem anterior à mensagem especificada pelo lookupId.
MessageLookupAction.First: espia a primeira mensagem na fila. O parâmetro lookupId deve ser definido como 0.
MessageLookupAction.Last: espia a última mensagem na fila. O parâmetro lookupId deve ser definido como 0.
- lookupId
- Int64
O LookupId da mensagem na qual espiar, ou 0. 0 é usado para acessar a primeira ou a última mensagem na fila.
Retornos
O Message especificado pelos parâmetros action e lookupId passados.
Exceções
O MSMQ 3.0 não está instalado.
Não foi possível localizar a mensagem com o lookupId especificado.
Erro ao acessar um método do serviço de Enfileiramento de Mensagens.
O parâmetro action não é um dos membros do MessageLookupAction.
Comentários
Use esse método para ler uma mensagem com um identificador de pesquisa conhecido sem removê-la da fila. Esse método gerará uma exceção imediatamente se a mensagem não estiver na fila.
A LookupId propriedade de uma mensagem é exclusiva para a fila em que a mensagem reside, portanto, haverá no máximo uma mensagem na fila que corresponde ao parâmetro especificado lookupId .
Para ler uma mensagem com um identificador especificado e removê-la da fila, use o ReceiveByLookupId método.
A tabela a seguir mostra se esse método está disponível em vários modos de grupo de trabalho.
| Modo de grupo de trabalho | Disponível |
|---|---|
| Computador local | Yes |
| Nome do computador local e do formato direto | Yes |
| Computador remoto | Não |
| Nome do computador remoto e do formato direto | Yes |