Freigeben über


Message.TransactionId Eigenschaft

Definition

Ruft die ID der Transaktion ab, in der die Meldung gesendet wurde.

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

Eigenschaftswert

Der Bezeichner der der Meldung zugeordneten Transaktion.

Attribute

Ausnahmen

Die Meldung wurde nicht gesendet. Diese Eigenschaft kann nur bei Meldungen gelesen werden, die aus einer Warteschlange abgerufen wurden.

- oder -

Die TransactionId-Eigenschaft wird aufgrund eines für die Meldungswarteschlange gesetzten Filters ignoriert.

Beispiele

Im folgenden Codebeispiel wird der Wert der Eigenschaft einer Nachricht TransactionId angezeigt.

Hinweise

Empfangende Anwendungen verwenden die TransactionId -Eigenschaft, um zu überprüfen, ob eine Nachricht im Rahmen einer bestimmten Transaktion gesendet wurde. Der Transaktionsbezeichner enthält den Bezeichner des sendenden Computers (erste 16 Bit) gefolgt von einer 4-Byte-Transaktionssequenznummer.

Diese Eigenschaft ist nur für Message Queuing, Version 2.0 und höher verfügbar.

Transaktionsbezeichner sind nicht garantiert eindeutig, da Transaktionssequenznummern nicht persistent sind und bei 2 20 von vorne beginnen. Message Queuing garantiert nur, dass nachfolgende Transaktionen unterschiedliche Transaktionssequenznummern aufweisen.

Sie können die TransactionId Eigenschaft zusammen mit den IsFirstInTransaction Eigenschaften und IsLastInTransaction verwenden, um Transaktionsgrenzen zu überprüfen.

Gilt für:

Weitere Informationen