Partager via


Message.IsFirstInTransaction Propriété

Définition

Obtient une valeur qui indique si le message était le premier message envoyé dans une transaction.

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

Valeur de propriété

true si le message était le premier message envoyé dans une transaction ; sinon, false.

Attributs

Exceptions

Le message n'a pas été envoyé. Cette propriété ne peut être lue que sur les messages récupérés à partir d'une file d'attente.

- ou -

La file d'attente des messages est filtrée pour ignorer la propriété IsFirstInTransaction.

Exemples

L’exemple de code suivant affiche la valeur de la propriété d’un IsFirstInTransaction message.

Remarques

Les applications de réception utilisent la IsFirstInTransaction propriété pour vérifier qu’un message a été le premier message envoyé dans une seule transaction à une seule file d’attente.

Cette propriété est disponible uniquement avec Message Queuing version 2.0 et ultérieure.

Pour vérifier les limites de transaction, vous pouvez utiliser la IsFirstInTransaction propriété avec deux autres propriétés : IsLastInTransaction et TransactionId. Utilisez le premier pour case activée si un message était le dernier message envoyé dans la transaction, et utilisez le second pour récupérer l’identificateur de la transaction.

Si un seul message est envoyé dans une transaction, les IsFirstInTransaction propriétés et IsLastInTransaction sont toutes deux définies sur true.

S’applique à

Voir aussi