CommittableTransaction Classe

Définition

Espace de noms:

System.Transactions

Assembly:

System.Transactions.Local.dll

Source:

CommittableTransaction.cs

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

public ref class CommittableTransaction sealed : System::Transactions::Transaction, IAsyncResult

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public sealed class CommittableTransaction : System.Transactions.Transaction, IAsyncResult

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type CommittableTransaction = class
    inherit Transaction
    interface IAsyncResult

Public NotInheritable Class CommittableTransaction
Inherits Transaction
Implements IAsyncResult

Héritage

Object

Transaction

CommittableTransaction

Attributs

UnsupportedOSPlatformAttribute

Implémente

IAsyncResult

Remarques

La classe CommittableTransaction permet aux applications d’utiliser une transaction de façon explicite au lieu d’utiliser la classe TransactionScope de façon implicite. Contrairement à la classe TransactionScope, le writer d’application doit absolument appeler les méthodes Commit et Rollback pour valider ou abandonner la transaction. Toutefois, seul le créateur d’une transaction peut valider la transaction. Par conséquent, les copies d’une transaction pouvant être validée obtenues par le biais de la Transaction.Clone méthode ne sont pas valides.

Notes

Nous vous recommandons de créer des transactions implicites à l’aide de la TransactionScope classe, afin que le contexte de transaction ambiant soit géré automatiquement pour vous. Vous devez également utiliser les TransactionScope classes et DependentTransaction pour les applications qui nécessitent l’utilisation de la même transaction sur plusieurs appels de fonction ou plusieurs appels de thread. Pour plus d’informations sur ce modèle, consultez la rubrique Implémentation d’une transaction implicite à l’aide de l’étendue de transaction .

La création d’un CommittableTransaction ne définit pas automatiquement la transaction ambiante, c’est-à-dire la transaction dans laquelle votre code s’exécute. Vous pouvez obtenir ou définir la transaction ambiante en appelant la propriété statique Transaction.Current de l’objet global Transaction . Pour plus d’informations sur les transactions ambiantes, consultez la section « Gestion du flux de transactions à l’aide de TransactionScopeOption » de la rubrique Implémentation d’une transaction implicite à l’aide de l’étendue de transaction . Si la transaction ambiante n’est pas définie, toute opération sur un gestionnaire de ressources ne fait pas partie de cette transaction. Vous devez définir et réinitialiser explicitement la transaction ambiante pour vous assurer que les gestionnaires de ressources fonctionnent dans le contexte de transaction approprié.

Tant qu’une CommittableTransaction valeur n’a pas été validée, toutes les ressources impliquées dans la transaction sont toujours verrouillées.

Un objet CommittableTransaction ne peut pas être réutilisé. Une fois qu’elle a été validée ou restaurée, elle ne peut plus être utilisée dans une transaction ou définie comme contexte de transaction ambiante actuel.

Constructeurs

CommittableTransaction()	Initialise une nouvelle instance de la classe CommittableTransaction.
CommittableTransaction(TimeSpan)	Initialise une nouvelle instance de la classe CommittableTransaction avec la valeur timeout spécifiée.
CommittableTransaction(TransactionOptions)	Initialise une nouvelle instance de la classe CommittableTransaction avec les options de transaction spécifiées.

Propriétés

IsolationLevel	Obtient le niveau d'isolement de la transaction. (Hérité de Transaction)
PromoterType	Identifie de façon unique le format de l'élément byte[] retourné par la méthode Promote quand la transaction est promue. (Hérité de Transaction)
TransactionInformation	Récupère des informations supplémentaires à propos d'une transaction. (Hérité de Transaction)

Méthodes

BeginCommit(AsyncCallback, Object)	Commence une tentative de validation de la transaction de façon asynchrone.
Clone()	Crée un clone de la transaction. (Hérité de Transaction)
Commit()	Essaie de valider la transaction.
DependentClone(DependentCloneOption)	Crée un clone dépendant de la transaction. (Hérité de Transaction)
Dispose()	Libère les ressources utilisées par l’objet. (Hérité de Transaction)
EndCommit(IAsyncResult)	Termine une tentative de validation de la transaction de façon asynchrone.
EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)	Inscrit un gestionnaire de ressources durable qui prend en charge la validation à deux phases pour participer à une transaction. (Hérité de Transaction)
EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)	Inscrit un gestionnaire de ressources durable qui prend en charge l'optimisation de la validation à phase unique pour participer à une transaction. (Hérité de Transaction)
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Inscrit un gestionnaire de ressources qui a une transaction interne à l'aide d'une inscription à phase unique pouvant être promue (PSPE). (Hérité de Transaction)
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Inscrit un gestionnaire de ressources qui a une transaction interne à l'aide d'une inscription à phase unique pouvant être promue (PSPE). (Hérité de Transaction)
EnlistVolatile(IEnlistmentNotification, EnlistmentOptions)	Inscrit un gestionnaire de ressources volatiles qui prend en charge la validation à deux phases pour participer à une transaction. (Hérité de Transaction)
EnlistVolatile(ISinglePhaseNotification, EnlistmentOptions)	Inscrit un gestionnaire de ressources volatil qui prend en charge l'optimisation de la validation à phase unique pour participer à une transaction. (Hérité de Transaction)
Equals(Object)	Détermine si cette transaction et l'objet spécifié sont égaux. (Hérité de Transaction)
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de Transaction)
GetPromotedToken()	Obtient le byte[] retourné par la Promote méthode lorsque la transaction est promue. (Hérité de Transaction)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
PromoteAndEnlistDurable(Guid, IPromotableSinglePhaseNotification, ISinglePhaseNotification, EnlistmentOptions)	Favorise et inscrit un gestionnaire de ressources durable qui prend en charge la validation à deux phases pour participer à une transaction. (Hérité de Transaction)
Rollback()	Restaure (abandonne) la transaction. (Hérité de Transaction)
Rollback(Exception)	Restaure (abandonne) la transaction. (Hérité de Transaction)
SetDistributedTransactionIdentifier(IPromotableSinglePhaseNotification, Guid)	Définit l'identificateur de transaction distribuée généré par le promoteur non-MSDTC. (Hérité de Transaction)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

TransactionCompleted

Indique que la transaction est terminée. (Hérité de Transaction)

Implémentations d’interfaces explicites

IAsyncResult.AsyncState	Obtient l'objet fourni comme dernier paramètre d'un appel à la méthode BeginCommit(AsyncCallback, Object).
IAsyncResult.AsyncWaitHandle	Obtient un WaitHandle qui est utilisé pour attendre qu’une opération asynchrone se termine.
IAsyncResult.CompletedSynchronously	Obtient une indication précisant si l'opération de validation asynchrone a été terminée de manière synchrone.
IAsyncResult.IsCompleted	Obtient une indication précisant si l'opération de validation asynchrone est terminée.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Obtient un SerializationInfo avec les données requises pour sérialiser cette transaction. (Hérité de Transaction)

Cohérence de thread

Ce type est thread-safe.

Voir aussi

• Implémentation d’une transaction implicite à l’aide de l’étendue de transaction
• Implémentation d’une transaction explicite à l’aide de CommitableTransaction