Message.TransactionId Proprietà

Definizione

Ottiene l'identificatore per la transazione di cui fa parte il messaggio.

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

Valore della proprietà

Identificatore per la transazione associata al messaggio.

Attributi

Eccezioni

Il messaggio non è stato inviato. Questa proprietà può essere letta solamente da messaggi recuperati da una coda.

-oppure-

La coda di messaggi viene filtrata in modo che venga ignorata la proprietà TransactionId.

Esempio

Nell'esempio di codice seguente viene visualizzato il valore della proprietà di TransactionId un messaggio.

Commenti

La ricezione delle applicazioni usa la TransactionId proprietà per verificare che un messaggio sia stato inviato come parte di una transazione specifica. L'identificatore della transazione contiene l'identificatore del computer di invio (primi 16 bit) seguito da un numero di sequenza di transazione a 4 byte.

Questa proprietà è disponibile solo per Accodamento messaggi versione 2.0 e successive.

Gli identificatori di transazione non sono sicuramente univoci, perché i numeri di sequenza di transazione non sono persistenti e ricominciano da 2 20. Accodamento messaggi garantisce solo che le transazioni successive avranno numeri di sequenza di transazione diversi.

È possibile utilizzare la TransactionId proprietà insieme IsFirstInTransaction alle proprietà e IsLastInTransaction per verificare i limiti delle transazioni.

Si applica a

Vedi anche