Message.LookupId Propriété
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.
Introduit dans MSMQ 3.0. Obtient l’identificateur de recherche du message.
public:
property long LookupId { long get(); };public long LookupId { get; }member this.LookupId : int64Public ReadOnly Property LookupId As LongValeur de propriété
Identificateur de recherche du message, généré par Message Queuing et unique à la file d’attente où réside le message.
Exceptions
MSMQ 3.0 n’est pas installé.
Le message n’a pas été envoyé. Cette propriété ne peut être lue que sur les messages récupérés à partir d’une file d’attente.
- ou -
La file d’attente de messages est filtrée pour ignorer la LookupId propriété.
Remarques
La LookupId propriété fournit un accès en lecture seule à l’identificateur de recherche d’un message. L’identificateur de recherche, introduit dans MSMQ 3.0, est un identificateur 64 bits généré par Message Queuing et affecté à chaque message lorsque le message est placé dans la file d’attente. L’identificateur de recherche n’est pas identique à l’identificateur de message généré lors de l’envoi du message.
Message Queuing génère un identificateur de recherche pour tous les messages placés dans n’importe quelle file d’attente, y compris la destination, l’administration et les files d’attente de rapports générées par l’application, ainsi que les files d’attente générées par le système, les lettres mortes, le connecteur et les files d’attente sortantes. En d’autres termes, cela inclut les deux messages envoyés par l’envoi d’applications et par Message Queuing. L’identificateur de recherche est unique à la file d’attente et n’a aucune signification en dehors de la file d’attente.
Si un message est envoyé à plusieurs files d’attente de destination ou si une copie d’un message est stockée dans un journal informatique ou un journal de file d’attente, chaque copie du message aura son propre identificateur de recherche lorsqu’il est placé dans sa file d’attente respective.
La LookupId propriété ne peut être lue que sur les messages récupérés à partir d’une file d’attente.
Un identificateur de recherche est utilisé pour lire un message spécifique dans la file d’attente. Une fois que l’identificateur de recherche d’un message est connu, l’application de réception peut appeler l’application PeekByLookupId ou ReceiveByLookupId la fonction pour accéder directement à ce message et l’examiner ou la récupérer à partir de la file d’attente, contrairement aux curseurs qui doivent commencer à l’avant de la file d’attente et naviguer vers la fin de la file d’attente,
L’obtention des identificateurs de recherche des messages dans la file d’attente est la responsabilité de l’application. Une façon possible d’obtenir les identificateurs de recherche consiste à créer un déclencheur pour la file d’attente de destination qui appelle un composant qui met en cache les identificateurs de chaque message au fur et à mesure qu’ils sont placés dans la file d’attente.
