System.Transactions Espace de noms

Contient des classes qui vous permettent d’écrire votre propre application transactionnelle et votre propre gestionnaire de ressources. Plus précisément, vous pouvez créer et participer à une transaction (locale ou distribuée) avec un ou plusieurs participants.

Classes

CommittableTransaction

Décrit une transaction pouvant être validée.

DependentTransaction

Décrit un clone d'une transaction qui garantit que la transaction ne peut pas être validée tant que l'application n'a pas fini son travail sur la transaction. Cette classe ne peut pas être héritée.

DistributedTransactionPermission

Autorisation qui est demandée par System.Transactions lorsque la gestion d'une transaction est remontée au MSDTC. Cette classe ne peut pas être héritée.

DistributedTransactionPermissionAttribute

Permet d’appliquer les actions de sécurité de DistributedTransactionPermission au code à l’aide de la sécurité déclarative. Cette classe ne peut pas être héritée.

Enlistment

Facilite la communication entre un participant de transaction inscrit et le gestionnaire de transactions pendant la phase finale de la transaction.

PreparingEnlistment

Facilite la communication entre un participant de transaction inscrit et le gestionnaire de transactions pendant la phase de préparation de la transaction.

SinglePhaseEnlistment

Fournit un jeu des rappels qui facilite la communication entre un participant inscrit pour une validation à phase unique et le gestionnaire de transactions lorsque la notification SinglePhaseCommit(SinglePhaseEnlistment) est reçue.

SubordinateTransaction

Représente une transaction non associée à une racine qui peut être déléguée. Cette classe ne peut pas être héritée.

Transaction

Représente une transaction.

TransactionAbortedException

Exception qui est levée lorsqu'une opération est tentée sur une transaction qui a déjà été restaurée ou lorsqu'une tentative est faite pour valider la transaction et que la transaction est abandonnée.

TransactionEventArgs

Fournit des données pour les événements de transaction suivants : DistributedTransactionStarted, TransactionCompleted.

TransactionException

Exception qui est levée lorsque vous essayez de faire du travail sur une transaction qui ne peut pas accepter de nouveau travail.

TransactionInDoubtException

Exception qui est levée lorsqu'une opération est tentée sur une transaction qui est dans le doute ou lorsqu'une tentative est faite pour valider la transaction et que la transaction devient InDoubt.

TransactionInformation

Fournit des informations supplémentaires sur une transaction.

TransactionInterop

Facilite l'interaction entre System.Transactions et les composants qui ont été écrits précédemment pour interagir avec MSDTC, COM+ ou System.EnterpriseServices. Cette classe ne peut pas être héritée.

TransactionManager

Contient des méthodes utilisées pour la gestion des transactions. Cette classe ne peut pas être héritée.

TransactionManagerCommunicationException

Exception levée lorsqu'un gestionnaire de ressources ne peut pas communiquer avec le gestionnaire de transactions.

TransactionPromotionException

Exception levée lorsqu'une promotion échoue.

TransactionScope

Rend un bloc de code transactionnel. Cette classe ne peut pas être héritée.

Structures

TransactionOptions

Contient des informations supplémentaires qui spécifient les comportements de transaction.

Interfaces

IDtcTransaction

Décrit une transaction DTC.

IEnlistmentNotification

Décrit une interface qu’un gestionnaire de ressources devrait implémenter pour fournir au gestionnaire des transactions des rappels de notification de validation à deux phases lors de l’inscription pour participation.

IPromotableSinglePhaseNotification

Décrit un objet qui sert de délégué de validation pour une transaction non distribuée interne à un gestionnaire de ressources.

ISimpleTransactionSuperior

Représente une transaction qui n'est pas une transaction de racine, mais peut être remontée pour être gérée par le MSDTC.

ISinglePhaseNotification

Décrit un objet de ressource qui prend en charge l’optimisation de la validation en une phase dans une transaction.

ITransactionPromoter

Décrit une transaction déléguée pour une transaction existante qui peut être remontée pour être gérée par le MSDTC, si nécessaire.

Énumérations

DependentCloneOption

Contrôle le type de transaction dépendante à créer.

EnlistmentOptions

Détermine si l'objet doit être inscrit pendant la phase de préparation.

EnterpriseServicesInteropOption

Spécifie comment les transactions distribuées interagissent avec les transactions COM+.

IsolationLevel

Spécifie le niveau d'isolement d'une transaction.

TransactionScopeAsyncFlowOption

Spécifie si le flux de transaction entre les continuations de thread est activé pour TransactionScope.

TransactionScopeOption

Fournit des options supplémentaires pour créer une portée de transaction.

TransactionStatus

Décrit l'état en cours d'une transaction distribuée.

Délégués

HostCurrentTransactionCallback

Fournit un mécanisme à l'environnement d'hébergement pour qu'il fournisse sa propre notion par défaut de Current.

TransactionCompletedEventHandler

Représente la méthode qui gère l'événement TransactionCompleted d'une classe Transaction.

TransactionStartedEventHandler

Représente la méthode destinée à gérer l’événement DistributedTransactionStarted d’une classe TransactionManager.

Remarques

L’infrastructure System.Transactions rend la programmation transactionnelle simple et efficace sur l’ensemble de la plateforme en prenant en charge les transactions initiées dans SQL Server, ADO.NET, MSMQ et microsoft Distributed Transaction Coordinator (MSDTC). Il fournit à la fois un modèle de programmation explicite basé sur la Transaction classe, ainsi qu’un modèle de programmation implicite utilisant la TransactionScope classe, dans lequel les transactions sont gérées automatiquement par l’infrastructure. Il est vivement recommandé d’utiliser le modèle implicite plus simple pour le développement. Pour commencer, consultez la rubrique Implémentation d’une transaction implicite à l’aide de l’étendue de transaction . Pour plus d’informations sur l’écriture d’une application transactionnelle, consultez Écriture d’une application transactionnelle.

System.Transactions fournit également des types permettant d’implémenter un gestionnaire de ressources. Le gestionnaire de transactions natif de l’infrastructure System.Transactions permet aux ressources volatiles ou à une inscription unique de ressources durables de valider ou de restaurer efficacement. Pour plus d’informations sur l’implémentation d’un gestionnaire de ressources, consultez Implémentation d’un gestionnaire de ressources.

Le gestionnaire de transactions fait également remonter de manière transparente les transactions locales aux transactions distribuées en se coordonnant via un gestionnaire de transactions sur disque comme le DTC, lorsqu’un gestionnaire de ressources durables supplémentaire s’inscrit auprès d’une transaction. L'infrastructure System.Transactions offre deux façons principales d'obtenir des performances améliorées.

  • Escalade dynamique, ce qui signifie que l’infrastructure System.Transactions n’engage le MSDTC que lorsqu’il est réellement nécessaire pour une transaction. Cette zone est traitée en détail dans la rubrique Escalade de la gestion des transactions .

  • Les inscriptions pouvant être promues, qui permettent à une ressource, telle qu’une base de données, de prendre possession de la transaction, s’il s’agit de la seule entité participant à la transaction. Plus tard, si nécessaire, l’infrastructure System.Transactions peut toujours transmettre la gestion de la transaction à MSDTC. Cela réduit encore la nécessité d'utiliser le MSDTC. Cette zone est traitée en détail dans la rubrique Optimisation à l’aide d’une validation monophase et d’une notification de phase unique promotable .

Pour plus d’informations sur l’utilisation de l’espace System.Transactions de noms, consultez Traitement des transactions.