Message.TransactionId Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Messaging
Zestaw:
System.Messaging.dll

Pobiera identyfikator transakcji, której część była komunikatem.

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

Wartość właściwości

String

Identyfikator transakcji skojarzonej z komunikatem.

Atrybuty
MessagingDescriptionAttribute

Wyjątki

InvalidOperationException

Wiadomość nie została wysłana. Ta właściwość może być odczytywana tylko w komunikatach pobranych z kolejki.

-lub-

Kolejka komunikatów jest filtrowana w celu zignorowania TransactionId właściwości.

Przykłady

Poniższy przykład kodu przedstawia wartość właściwości komunikatu TransactionId .

Uwagi

Odbieranie aplikacji używa TransactionId właściwości , aby sprawdzić, czy komunikat został wysłany w ramach określonej transakcji. Identyfikator transakcji zawiera identyfikator komputera wysyłającego (pierwsze 16 bitów), po którym następuje 4-bajtowy numer sekwencji transakcji.

Ta właściwość jest dostępna tylko w przypadku kolejkowania komunikatów w wersji 2.0 lub nowszej.

Identyfikatory transakcji nie są gwarantowane jako unikatowe, ponieważ numery sekwencji transakcji nie są trwałe i zaczynają się od nowa o wartości 2 20. Kolejkowanie komunikatów gwarantuje tylko, że kolejne transakcje będą miały różne numery sekwencji transakcji.

Możesz użyć TransactionId właściwości wraz z właściwościami IsFirstInTransaction i IsLastInTransaction , aby zweryfikować granice transakcji.

Dotyczy

Zobacz też