Message.TransactionId Properti

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

Mendapatkan pengidentifikasi untuk transaksi yang pesannya merupakan bagiannya.

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

Nilai Properti

String

Pengidentifikasi untuk transaksi yang terkait dengan pesan.

Atribut

MessagingDescriptionAttribute

Pengecualian

InvalidOperationException

Pesan belum dikirim. Properti ini hanya dapat dibaca pada pesan yang diambil dari antrean.

-atau-

Antrean pesan difilter untuk mengabaikan TransactionId properti .

Contoh

Contoh kode berikut menampilkan nilai properti pesan TransactionId .

Keterangan

Menerima aplikasi menggunakan TransactionId properti untuk memverifikasi bahwa pesan dikirim sebagai bagian dari transaksi tertentu. Pengidentifikasi transaksi berisi pengidentifikasi komputer pengirim (16 bit pertama) diikuti dengan nomor urutan transaksi 4 byte.

Properti ini hanya tersedia untuk Antrean Pesan versi 2.0 dan yang lebih baru.

Pengidentifikasi transaksi tidak dijamin unik, karena nomor urutan transaksi tidak persisten, dan mereka memulai kembali pada 2 ²⁰. Antrean Pesan hanya menjamin bahwa transaksi berikutnya akan memiliki nomor urutan transaksi yang berbeda.

Anda dapat menggunakan TransactionId properti bersama dengan IsFirstInTransaction properti dan IsLastInTransaction untuk memverifikasi batas transaksi.

Lihat juga

• IsFirstInTransaction
• IsLastInTransaction
• Transactional