Message.TransactionId Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém o identificador da transação da qual a mensagem fazia parte.
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
Valor de Propriedade
O identificador da transação associada à mensagem.
- Atributos
Exceções
A mensagem não foi enviada. Esta propriedade só pode ser lida em mensagens recuperadas de uma fila.
-ou-
A fila de mensagens é filtrada para ignorar a TransactionId propriedade.
Exemplos
O seguinte exemplo de código mostra o valor da propriedade de TransactionId uma mensagem.
Observações
As aplicações recetoras utilizam a TransactionId propriedade para verificar se uma mensagem foi enviada como parte de uma transação específica. O identificador de transação contém o identificador do computador remetente (primeiros 16 bits) seguido de um número de sequência de transação de 4 bytes.
Esta propriedade está disponível apenas para a Message Queuing versão 2.0 e posteriores.
Os identificadores de transação não têm garantia de serem únicos, porque os números de sequência das transações não são persistentes e recomeçam em 2 20. A Fila de Mensagens garante apenas que as transações subsequentes terão números de sequência diferentes.
Pode usar a TransactionId propriedade juntamente com as IsFirstInTransaction propriedades e IsLastInTransaction para verificar os limites das transações.