Message.TransactionId Propriedade

Definição

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.

Aplica-se a

Ver também