Message.TransactionId Propriedade

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

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

String

O identificador da transação associada à mensagem.

Atributos

MessagingDescriptionAttribute

Exceções

InvalidOperationException

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 ²⁰. 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.

Confira também

• IsFirstInTransaction
• IsLastInTransaction
• Transactional