Message.TransactionId 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.
Obtient l'identificateur pour la transaction dont faisait partie le message.
public:
property System::String ^ TransactionId { System::String ^ get(); };
[System.Messaging.MessagingDescription("MsgTransactionId")]
public string TransactionId { get; }
[<System.Messaging.MessagingDescription("MsgTransactionId")>]
member this.TransactionId : string
Public ReadOnly Property TransactionId As String
Valeur de propriété
L'identificateur pour la transaction associée au message.
- Attributs
Exceptions
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é TransactionId.
Exemples
L’exemple de code suivant affiche la valeur de la propriété d’un TransactionId message.
Remarques
Les applications de réception utilisent la TransactionId propriété pour vérifier qu’un message a été envoyé dans le cadre d’une transaction spécifique. L’identificateur de transaction contient l’identificateur de l’ordinateur d’envoi (16 premiers bits) suivi d’un numéro de séquence de transaction de 4 octets.
Cette propriété est disponible uniquement pour Message Queuing version 2.0 et ultérieures.
Il n’est pas garanti que les identificateurs de transaction soient uniques, car les numéros de séquence de transaction ne sont pas persistants et ils recommencent à 2 20. Message Queuing garantit uniquement que les transactions suivantes auront des numéros de séquence de transaction différents.
Vous pouvez utiliser la TransactionId propriété avec les IsFirstInTransaction propriétés et IsLastInTransaction pour vérifier les limites de transaction.