Message.TransactionId Vlastnost

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Získá identifikátor transakce, jejíž součástí byla zpráva.

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

Hodnota vlastnosti

String

Identifikátor transakce přidružené ke zprávě.

Atributy

MessagingDescriptionAttribute

Výjimky

InvalidOperationException

Zpráva nebyla odeslána. Tuto vlastnost lze číst pouze u zpráv načtených z fronty.

-nebo-

Fronta zpráv je filtrována tak, aby ignorovala TransactionId vlastnost.

Příklady

Následující příklad kódu zobrazí hodnotu vlastnosti zprávy TransactionId .

Poznámky

Přijímající aplikace používají TransactionId vlastnost k ověření, že zpráva byla odeslána jako součást konkrétní transakce. Identifikátor transakce obsahuje identifikátor odesílajícího počítače (prvních 16 bitů) následovaný 4 bajtovým pořadovým číslem transakce.

Tato vlastnost je k dispozici pouze pro službu Řízení front zpráv verze 2.0 a novější.

Identifikátory transakcí nejsou zaručeny jako jedinečné, protože čísla posloupnosti transakcí nejsou trvalá a začínají znovu na 2 ²⁰. Řízení front zpráv zaručuje pouze, že následující transakce budou mít různá čísla posloupnosti transakcí.

K ověření hranic transakcí můžete použít TransactionId vlastnost spolu s vlastnostmi IsFirstInTransaction a IsLastInTransaction .

Viz také

• IsFirstInTransaction
• IsLastInTransaction
• Transactional