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 por sua posição na frente ou no final da fila.
Sobrecargas
| Nome | Description |
|---|---|
| PeekByLookupId(Int64) |
Introduzido no MSMQ 3.0. Espia a 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 por sua posição na frente ou no final da fila. |
PeekByLookupId(Int64)
Introduzido no MSMQ 3.0. Espia a 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
A Message propriedade cuja LookupId propriedade corresponde ao lookupId parâmetro passado.
Exceções
O MSMQ 3.0 não está instalado.
A mensagem com a especificada lookupId não pôde ser encontrada.
Ocorreu um erro ao acessar um método 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 gera uma exceção imediatamente se a mensagem não estiver na fila.
A LookupId propriedade de uma mensagem é exclusiva da 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 | Sim |
| Nome do computador local e do formato direto | Sim |
| Computador remoto | No |
| Computador remoto e nome do formato direto | Sim |
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 por sua posição na frente 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 MessageLookupAction valores, especificando como a mensagem é lida na fila. Especifique um dos seguintes:
MessageLookupAction.Current: espia a mensagem especificada por lookupId.
MessageLookupAction.Next: espia a mensagem seguindo a mensagem especificada por lookupId.
MessageLookupAction.Previous: espia a mensagem anterior à mensagem especificada por lookupId.
MessageLookupAction.First: espia a primeira mensagem na fila. O lookupId parâmetro deve ser definido como 0.
MessageLookupAction.Last: espia a última mensagem na fila. O lookupId parâmetro deve ser definido como 0.
- lookupId
- Int64
A LookupId da mensagem para espiar, ou 0. 0 é usado ao acessar a primeira ou última mensagem na fila.
Retornos
O Message especificado pelo e lookupId parâmetros action passados.
Exceções
O MSMQ 3.0 não está instalado.
A mensagem com a especificada lookupId não pôde ser encontrada.
Ocorreu um erro ao acessar um método de Enfileiramento de Mensagens.
O action parâmetro não é um dos MessageLookupAction membros.
Comentários
Use esse método para ler uma mensagem com um identificador de pesquisa conhecido sem removê-la da fila. Esse método gera uma exceção imediatamente se a mensagem não estiver na fila.
A LookupId propriedade de uma mensagem é exclusiva da 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 | Sim |
| Nome do computador local e do formato direto | Sim |
| Computador remoto | No |
| Computador remoto e nome do formato direto | Sim |
