Message.IsFirstInTransaction 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 um valor que indica se a mensagem foi a primeira mensagem enviada em uma 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 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 true
como .