Message.TransactionId Propriété

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

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é

String

L'identificateur pour la transaction associée au message.

Attributs

MessagingDescriptionAttribute

Exceptions

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é 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 ²⁰. 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.

Voir aussi

• IsFirstInTransaction
• IsLastInTransaction
• Transactional