DbConnection.BeginDbTransactionAsync Méthode

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbConnection.cs

Démarre de manière asynchrone une transaction de base de données.

protected:
 virtual System::Threading::Tasks::ValueTask<System::Data::Common::DbTransaction ^> BeginDbTransactionAsync(System::Data::IsolationLevel isolationLevel, System::Threading::CancellationToken cancellationToken);

protected virtual System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginDbTransactionAsync (System.Data.IsolationLevel isolationLevel, System.Threading.CancellationToken cancellationToken);

abstract member BeginDbTransactionAsync : System.Data.IsolationLevel * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>
override this.BeginDbTransactionAsync : System.Data.IsolationLevel * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>

Protected Overridable Function BeginDbTransactionAsync (isolationLevel As IsolationLevel, cancellationToken As CancellationToken) As ValueTask(Of DbTransaction)

Paramètres

isolationLevel

IsolationLevel

Une des valeurs d'énumération, qui spécifie le niveau d’isolation pour la transaction à utiliser.

cancellationToken

CancellationToken

Jeton pour annuler l’opération asynchrone.

Retours

ValueTask<DbTransaction>

Une tâche dont la propriété Result est un objet représentant la nouvelle transaction.

Exceptions

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

L’implémentation par défaut de cette méthode asynchrone délègue à son équivalent synchrone et retourne un terminé Task, bloquant potentiellement le thread appelant.

Les fournisseurs de données qui prennent en charge la programmation asynchrone doivent remplacer l’implémentation par défaut à l’aide d’opérations d’E/S asynchrones.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par BeginDbTransaction(IsolationLevel).