Ler em inglês

Partilhar via


Message.IsFirstInTransaction Propriedade

Definição

Obtém um valor que indica se a mensagem foi a primeira mensagem enviada em uma transação.

[System.Messaging.MessagingDescription("MsgIsFirstInTransaction")]
public bool IsFirstInTransaction { get; }

Valor da propriedade

true se a mensagem foi a primeira mensagem enviada em uma transação; caso contrário, false.

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 IsFirstInTransaction.

Exemplos

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

Comentários

O recebimento de aplicativos usa a IsFirstInTransaction propriedade para verificar se uma mensagem foi a primeira mensagem enviada em uma única transação para uma única fila.

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

Para verificar os limites da transação, você pode usar a IsFirstInTransaction propriedade junto com duas outras propriedades: IsLastInTransaction e TransactionId. Use o primeiro para marcar se uma mensagem foi a última mensagem enviada na transação e use a última para recuperar o identificador da transação.

Se apenas uma mensagem for enviada em uma transação, as IsFirstInTransaction propriedades e IsLastInTransaction serão definidas truecomo .

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também