Message.TransactionId Eigenschaft

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

String

Der Bezeichner der der Meldung zugeordneten Transaktion.

Attribute: MessagingDescriptionAttribute

Ausnahmen

InvalidOperationException

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 ²⁰ 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: