Message.LookupId Propriété

  • Référence

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

Présentation dans MSMQ 3.0. Obtient l'identificateur de la recherche du message.

public:
 property long LookupId { long get(); };
public long LookupId { get; }
member this.LookupId : int64
Public ReadOnly Property LookupId As Long

Valeur de propriété

Int64

Identificateur de recherche du message qui est généré par Message Queuing, et est unique dans la file d'attente où se trouve le message.

Exceptions

PlatformNotSupportedException

MSMQ 3.0 n'est pas installé.

InvalidOperationException

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 des messages est filtrée pour ignorer la propriété LookupId.

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 le même que 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 une file d’attente, y compris les files d’attente de destination, d’administration et de rapport générées par l’application, ainsi que les files d’attente de journal, de lettres mortes, de connecteurs et sortantes générées par le système. En d’autres termes, cela inclut à la fois les messages envoyés par l’envoi d’applications et par Message Queuing. L’identificateur de recherche est propre à 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 d’ordinateur ou un journal de file d’attente, chaque copie du message aura son propre identificateur de recherche lorsqu’elle sera placée 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 réceptrice peut appeler la PeekByLookupId fonction ou ReceiveByLookupId pour accéder directement à ce message et le récupérer à partir de la file d’attente, contrairement aux curseurs qui doivent démarrer à 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 incombe à 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 à mesure qu’ils sont placés dans la file d’attente.

S’applique à

Voir aussi