MessageQueue.PeekByLookupId Méthode

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Introduit dans MSMQ 3.0. Examine un message spécifique de la file d’attente. Le message peut être spécifié par un identificateur de recherche ou par sa position à l’avant ou à la fin de la file d’attente.

Surcharges

Nom	Description
PeekByLookupId(Int64)	Introduit dans MSMQ 3.0. Examine le message qui correspond à l’identificateur de recherche donné à partir d’une file d’attente non transactionnelle.
PeekByLookupId(MessageLookupAction, Int64)	Introduit dans MSMQ 3.0. Examine un message spécifique de la file d’attente. Le message peut être spécifié par un identificateur de recherche ou par sa position à l’avant ou à la fin de la file d’attente.

PeekByLookupId(Int64)

Introduit dans MSMQ 3.0. Examine le message qui correspond à l’identificateur de recherche donné à partir d’une file d’attente non transactionnelle.

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

Paramètres

lookupId

Int64

Le LookupId message à examiner.

Retours

Message

Dont Message la propriété correspond au lookupId paramètre LookupId passé.

Exceptions

PlatformNotSupportedException

MSMQ 3.0 n’est pas installé.

InvalidOperationException

Impossible de trouver le message avec le message spécifié lookupId .

MessageQueueException

Une erreur s’est produite lors de l’accès à une méthode Message Queuing.

Remarques

Utilisez cette méthode pour lire un message avec un identificateur de recherche connu sans le supprimer de la file d’attente. Cette méthode lève immédiatement une exception si le message n’est pas dans la file d’attente.

La LookupId propriété d’un message est unique à la file d’attente où réside le message. Il y aura donc au maximum un message dans la file d’attente qui correspond au paramètre donné lookupId .

Pour lire un message avec un identificateur de recherche spécifié et le supprimer de la file d’attente, utilisez la ReceiveByLookupId méthode.

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Oui
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Oui

Voir aussi

• LookupId
• ReceiveByLookupId

PeekByLookupId(MessageLookupAction, Int64)

Introduit dans MSMQ 3.0. Examine un message spécifique de la file d’attente. Le message peut être spécifié par un identificateur de recherche ou par sa position à l’avant ou à la fin de la file d’attente.

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

Paramètres

action

MessageLookupAction

Une des MessageLookupAction valeurs, en spécifiant la façon dont le message est lu dans la file d’attente. Spécifiez l'une des valeurs suivantes :

MessageLookupAction.Current: examine le message spécifié par lookupId.

MessageLookupAction.Next: examine le message suivant le message spécifié par lookupId.

MessageLookupAction.Previous: examine le message qui précède le message spécifié par lookupId.

MessageLookupAction.First: examine le premier message de la file d’attente. Le lookupId paramètre doit être défini sur 0.

MessageLookupAction.Last: examine le dernier message de la file d’attente. Le lookupId paramètre doit être défini sur 0.

lookupId

Int64

Le LookupId message à examiner, ou 0. 0 est utilisé lors de l’accès au premier ou dernier message dans la file d’attente.

Retours

Message

Message Spécifié par les action paramètres et lookupId transmis.

Exceptions

PlatformNotSupportedException

MSMQ 3.0 n’est pas installé.

InvalidOperationException

Impossible de trouver le message avec le message spécifié lookupId .

MessageQueueException

Une erreur s’est produite lors de l’accès à une méthode Message Queuing.

InvalidEnumArgumentException

Le action paramètre n’est pas l’un des MessageLookupAction membres.

Remarques

Utilisez cette méthode pour lire un message avec un identificateur de recherche connu sans le supprimer de la file d’attente. Cette méthode lève immédiatement une exception si le message n’est pas dans la file d’attente.

La LookupId propriété d’un message est unique à la file d’attente où réside le message. Il y aura donc au maximum un message dans la file d’attente qui correspond au paramètre donné lookupId .

Pour lire un message avec un identificateur spécifié et le supprimer de la file d’attente, utilisez la ReceiveByLookupId méthode.

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Oui
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Oui

Voir aussi

• LookupId
• ReceiveByLookupId