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
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.
