CommittableTransaction Classe

Référence

Définition

Espace de noms:: System.Transactions

Assembly:: System.Transactions.Local.dll

Assembly:: System.Transactions.dll

Assembly:: netstandard.dll

Source:: CommittableTransaction.cs

Source:: CommittableTransaction.cs

Source:: CommittableTransaction.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

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

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

[System.Serializable]
public sealed class CommittableTransaction : System.Transactions.Transaction, IAsyncResult

type CommittableTransaction = class
    inherit Transaction
    interface IAsyncResult

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

[<System.Serializable>]
type CommittableTransaction = class
    inherit Transaction
    interface IAsyncResult

Public NotInheritable Class CommittableTransaction
Inherits Transaction
Implements IAsyncResult

Héritage: Object

Transaction
CommittableTransaction

Attributs: UnsupportedOSPlatformAttribute SerializableAttribute

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)

S’applique à

Cohérence de thread

Ce type est thread-safe.

Partager via