Message.TransactionId Eigenschaft
Definition
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 : stringPublic ReadOnly Property TransactionId As StringEigenschaftswert
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
Beim Empfangen von Anwendungen wird die TransactionId Eigenschaft verwendet, um zu überprüfen, ob eine Nachricht als Teil einer bestimmten Transaktion gesendet wurde. Der Transaktionsbezeichner enthält den Bezeichner des Sendecomputers (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 beständig sind und wieder bei 2 2 20 beginnen. Message Queuing garantiert nur, dass nachfolgende Transaktionen unterschiedliche Transaktionssequenznummern aufweisen.
Sie können die Eigenschaft zusammen mit den TransactionId IsFirstInTransaction Eigenschaften IsLastInTransaction verwenden, um Transaktionsgrenzen zu überprüfen.