MessageQueue.PeekByLookupId Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Présentation dans MSMQ 3.0. Lit un message spécifique de la file d'attente. Le message peut être spécifié par un identificateur de recherche ou par sa position au début ou à la fin de la file d'attente.
Surcharges
| PeekByLookupId(Int64) |
Présentation dans MSMQ 3.0. Lit le message qui correspond à l'identificateur de recherche donné d'une file d'attente non transactionnelle. |
| PeekByLookupId(MessageLookupAction, Int64) |
Présentation dans MSMQ 3.0. Lit un message spécifique de la file d'attente. Le message peut être spécifié par un identificateur de recherche ou par sa position au début ou à la fin de la file d'attente. |
PeekByLookupId(Int64)
Présentation dans MSMQ 3.0. Lit le message qui correspond à l'identificateur de recherche donné 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.MessagePublic Function PeekByLookupId (lookupId As Long) As MessageParamètres
Retours
Message dont la propriété LookupId correspond au paramètre lookupId passé.
Exceptions
MSMQ 3.0 n'est pas installé.
Impossible de trouver le message avec le paramètre lookupId spécifié.
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 étant propre à la file d’attente où réside le message, il y aura 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
S’applique à
PeekByLookupId(MessageLookupAction, Int64)
Présentation dans MSMQ 3.0. Lit un message spécifique de la file d'attente. Le message peut être spécifié par un identificateur de recherche ou par sa position au début 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.MessagePublic Function PeekByLookupId (action As MessageLookupAction, lookupId As Long) As MessageParamètres
- action
- MessageLookupAction
L'une des valeurs MessageLookupAction, spécifiant comment le message est lu dans la file d'attente. Spécifiez l'une des valeurs suivantes :
MessageLookupAction.Current : lit le message spécifié par lookupId.
MessageLookupAction.Next : lit le message qui suit le message spécifié par lookupId.
MessageLookupAction.Previous : lit le message qui précède le message spécifié par lookupId.
MessageLookupAction.First : lit le premier message de la file d'attente. Le paramètre lookupId doit avoir la valeur 0.
MessageLookupAction.Last : lit le dernier message de la file d'attente. Le paramètre lookupId doit avoir la valeur 0.
- lookupId
- Int64
Propriété LookupId du message à lire ou 0. 0 est utilisé lors de l'accès au premier ou dernier message de la file d'attente.
Retours
Message spécifié par les paramètres action et lookupId passés.
Exceptions
MSMQ 3.0 n'est pas installé.
Impossible de trouver le message avec le paramètre lookupId spécifié.
Une erreur s'est produite lors de l'accès à une méthode Message Queuing.
Le paramètre action ne fait pas partie des membres MessageLookupAction.
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 étant propre à la file d’attente où réside le message, il y aura 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 |
