Compartilhar via


Message.TransactionId Propriedade

Definição

Obtém o identificador para a 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 da propriedade

O identificador da transação associada à mensagem.

Atributos

Exceções

A mensagem não foi enviada. Essa propriedade só pode ser lida em mensagens recuperadas de uma fila.

- ou -

A fila de mensagens é filtrada para ignorar a propriedade TransactionId.

Exemplos

O exemplo de código a seguir exibe o valor da propriedade de TransactionId uma mensagem.

Comentários

Os aplicativos de recebimento usam 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 de envio (primeiros 16 bits) seguido por um número de sequência de transações de 4 bytes.

Essa propriedade está disponível apenas para o Enfileiramento de Mensagens versão 2.0 e posterior.

Não há garantia de que os identificadores de transação sejam exclusivos, pois os números de sequência de transações não são persistentes e começam novamente em 2 20. O Enfileiramento de Mensagens garante apenas que as transações subsequentes terão números de sequência de transações diferentes.

Você pode usar a TransactionId propriedade junto com as IsFirstInTransaction propriedades e IsLastInTransaction para verificar os limites da transação.

Aplica-se a

Confira também