Partilhar via


MessageQueue.PeekByLookupId Método

Definição

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.Message
Public Function PeekByLookupId (lookupId As Long) As Message

Parâmetros

lookupId
Int64

O LookupId da mensagem a espiar.

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 da fila em que a mensagem reside, portanto, haverá no máximo uma mensagem na fila que corresponda 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
Computador remoto e nome de 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.Message
Public Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As Message

Parâ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 da fila em que a mensagem reside, portanto, haverá no máximo uma mensagem na fila que corresponda 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
Computador remoto e nome de formato direto Yes

Confira também

Aplica-se a