Compartilhar via


Message.IsFirstInTransaction Propriedade

Definição

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

Aplica-se a

Confira também