MessageQueue.PeekByLookupId Método

Definição

Espaço de Nomes:: System.Messaging

Assemblagem:: System.Messaging.dll

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. Espreita uma mensagem específica da fila. A mensagem pode ser especificada por um identificador de consulta ou pela sua posição no início ou fim da fila.

Sobrecargas

Name	Description
PeekByLookupId(Int64)	Introduzido no MSMQ 3.0. Espreita a mensagem que corresponde ao identificador de pesquisa dado numa fila não transacional.
PeekByLookupId(MessageLookupAction, Int64)	Introduzido no MSMQ 3.0. Espreita uma mensagem específica da fila. A mensagem pode ser especificada por um identificador de consulta ou pela sua posição no início ou fim da fila.

PeekByLookupId(Int64)

Introduzido no MSMQ 3.0. Espreita a mensagem que corresponde ao identificador de pesquisa dado numa 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

A LookupId mensagem para espreitar.

Devoluções

Message

A Message propriedade cujo LookupId corresponde ao lookupId parâmetro passado em.

Exceções

PlatformNotSupportedException

O MSMQ 3.0 não está instalado.

InvalidOperationException

A mensagem com o especificado lookupId não foi encontrada.

MessageQueueException

Ocorreu um erro ao aceder a um método de Fila de Mensagens.

Observações

Use este método para ler uma mensagem com um identificador de pesquisa conhecido sem a remover da fila. Este método lança uma exceção imediatamente se a mensagem não estiver na fila.

A LookupId propriedade de uma mensagem é única para a fila onde a mensagem reside, pelo que haverá no máximo uma mensagem na fila que corresponde ao parâmetro indicado lookupId .

Para ler uma mensagem com um identificador de pesquisa especificado e removê-la da fila, use o ReceiveByLookupId método.

A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho	Available
Computador local	Yes
Computador local e nome do formato direto	Yes
Computador remoto	No
Computador remoto e nome do formato direto	Yes

Ver também

Aplica-se a

PeekByLookupId(MessageLookupAction, Int64)

Introduzido no MSMQ 3.0. Espreita uma mensagem específica da fila. A mensagem pode ser especificada por um identificador de consulta ou pela sua posição no início ou fim 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 MessageLookupAction valores, especificando como a mensagem é lida na fila. Especifique uma das seguintes opções:

MessageLookupAction.Current: Espreita a mensagem especificada por lookupId.

MessageLookupAction.Next: Espreita a mensagem após a mensagem especificada por lookupId.

MessageLookupAction.Previous: Espreita a mensagem que precede a mensagem especificada por lookupId.

MessageLookupAction.First: Espreita a primeira mensagem na fila. O lookupId parâmetro deve ser definido para 0.

MessageLookupAction.Last: Espreita a última mensagem na fila. O lookupId parâmetro deve ser definido para 0.

lookupId: Int64

A LookupId mensagem para espreitar, ou 0. 0 é usado ao aceder à primeira ou última mensagem na fila.

Devoluções

Message

Os Message parâmetros especificados por action e lookupId passaram em.