Message.IsFirstInTransaction Propriedade

Definição

Recebe um valor que indica se a mensagem foi a primeira enviada numa transação.

public:
 property bool IsFirstInTransaction { bool get(); };
[System.Messaging.MessagingDescription("MsgIsFirstInTransaction")]
public bool IsFirstInTransaction { get; }
[<System.Messaging.MessagingDescription("MsgIsFirstInTransaction")>]
member this.IsFirstInTransaction : bool
Public ReadOnly Property IsFirstInTransaction As Boolean

Valor de Propriedade

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

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

Exemplos

O seguinte exemplo de código mostra o valor da propriedade de IsFirstInTransaction uma mensagem.

Observações

As aplicações recetoras usam a IsFirstInTransaction propriedade para verificar se uma mensagem foi a primeira enviada numa única transação para uma única fila.

Esta propriedade está disponível apenas com a Message Queuing versão 2.0 e posteriores.

Para verificar os limites das transações, pode usar a IsFirstInTransaction propriedade juntamente com outras duas propriedades: IsLastInTransaction e TransactionId. Use a primeira para verificar se uma mensagem foi a última enviada na transação, e use a segunda para recuperar o identificador da transação.

Se apenas uma mensagem for enviada numa transação, as IsFirstInTransaction propriedades e IsLastInTransaction são ambas definidas como true.

Aplica-se a

Ver também