Message.TransactionId Vlastnost

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

Získá identifikátor pro transakci, ze které byla zpráva součástí.

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říjem aplikací používá 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 číslem sekvence 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 jedinečné, protože pořadová čísla transakcí nejsou trvalá a začínají znovu na 2 ²⁰. Řízení front zpráv zaručuje pouze to, že následné transakce budou mít různá pořadová čísla transakcí.

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

Viz také

• IsFirstInTransaction
• IsLastInTransaction
• Transactional