Message.TransactionId Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.