Message.IsFirstInTransaction Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.