Message.TransactionId Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 : stringPublic ReadOnly Property TransactionId As StringValor 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.
