Message.TransactionId-Eigenschaft

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

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public ReadOnly Property TransactionId As String
'Usage
Dim instance As Message
Dim value As String

value = instance.TransactionId

public string TransactionId { get; }

public:
property String^ TransactionId {
    String^ get ();
}

/** @property */
public String get_TransactionId ()

public function get TransactionId () : String

Eigenschaftenwert

Die ID der zugeordneten Transaktion.

Ausnahmen

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

Hinweise

Empfangende Anwendungen überprüfen anhand der TransactionId-Eigenschaft, ob eine Meldung innerhalb einer bestimmten Transaktion gesendet wurde. Die Transaktions-ID enthält den Bezeichner des sendenden Computers (in den ersten 16 Bits) gefolgt von einer 4-Byte-Sequenznummer für die Transaktion.

Diese Eigenschaft steht nur unter Message Queuing ab Version 2.0 zur Verfügung.

Für Transaktions-IDs wird keine eindeutige Vergabe gewährleistet, da Sequenznummern für Transaktionen nicht persistent sind und die Zählung bei 2 ²⁰ wieder von vorn begonnen wird. Message Queuing garantiert nur, dass aufeinander folgende Transaktionen unterschiedliche Transaktionsnummern haben.

Zur Überprüfung von Transaktionsgrenzen können Sie die TransactionId-Eigenschaft zusammen mit der IsFirstInTransaction-Eigenschaft und der IsLastInTransaction-Eigenschaft verwenden.

Beispiel

Im folgenden Codebeispiel wird der Wert der TransactionId-Eigenschaft einer Meldung angezeigt.

// Display the value of the message's TransactionId property.
// To view this property value, the queue's
// MessageReadPropertyFilter.TransactionId property must be set to true
// before the message is received.
Console.WriteLine("Message.TransactionId: {0}",
    orderMessage.TransactionId);

// Display the value of the message's TransactionId property.
// To view this property value, the queue's
// MessageReadPropertyFilter.TransactionId property must be set to true
// before the message is received.
Console::WriteLine("Message.TransactionId: {0}",
    orderMessage->TransactionId);

// Display the value of the message's TransactionId property.
// To view this property value, the queue's
// MessageReadPropertyFilter.TransactionId property must be set to true
// before the message is received.
Console.WriteLine("Message.TransactionId: {0}", 
    System.Convert.ToString(orderMessage.get_TransactionId()));

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

Message-Klasse
Message-Member
System.Messaging-Namespace
Message.IsFirstInTransaction-Eigenschaft
Message.IsLastInTransaction-Eigenschaft
Transactional