DbBatch Classe

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbBatch.cs

Représente un lot de commandes qui peuvent être exécutées sur une source de données en un seul aller-retour. Fournit une classe de base pour les classes spécifiques à la base de données qui représentent des lots de commandes.

public ref class DbBatch abstract : IAsyncDisposable, IDisposable

public abstract class DbBatch : IAsyncDisposable, IDisposable

type DbBatch = class
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbBatch
Implements IAsyncDisposable, IDisposable

Héritage

Object

DbBatch

Implémente

IAsyncDisposable IDisposable

Remarques

La sémantique précise de l’exécution par lots varie selon ADO.NET fournisseurs, en particulier en ce qui concerne la gestion des erreurs. Lorsque cela est possible, il est recommandé qu’une erreur dans une commande dans le lot arrête immédiatement le lot, ignore toutes les commandes suivantes et restaure les commandes déjà exécutées. Toutefois, ce comportement peut ne pas être pris en charge entre les bases de données ; consultez la documentation de votre fournisseur de ADO.NET.

Constructeurs

DbBatch()

Initialise une nouvelle instance de la classe DbBatch.

Propriétés

BatchCommands	Obtient la collection d'objets DbBatchCommand.
Connection	Obtient ou définit l'objet DbConnection utilisé par cette classe DbBatch.
DbBatchCommands	En cas de substitution dans une classe dérivée, obtient la collection d’objets DbBatchCommand.
DbConnection	En cas de substitution dans une classe dérivée, obtient ou définit la DbConnection utilisée par cette DbBatch.
DbTransaction	En cas de remplacement dans une classe dérivée, obtient ou définit la DbTransaction dans laquelle cet objet DbBatch s’exécute.
Timeout	Obtient ou définit le temps d’attente (en secondes) avant de mettre fin à la tentative d’exécution du lot et de générer une erreur.
Transaction	Obtient ou définit la DbTransaction dans laquelle l’objet DbBatch s’exécute.

Méthodes

Cancel()	Tente d’annuler l’exécution d’un DbBatch.
CreateBatchCommand()	Crée une nouvelle instance d'un objet DbBatchCommand.
CreateDbBatchCommand()	En cas de substitution dans une classe dérivée, crée une instance d'un objet DbBatchCommand.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
DisposeAsync()	Dipose de façon asynchrone l’objet batch.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
ExecuteDbDataReader(CommandBehavior)	En cas de substitution dans une classe dérivée, exécute le lot sur sa connexion, en retournant un DbDataReader qui peut être utilisé pour accéder aux résultats.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Les fournisseurs doivent implémenter cette méthode pour assurer une implémentation non définie par défaut pour les surcharges ExecuteReader. L'implémentation par défaut appelle la méthode ExecuteReader() synchrone et retourne une tâche terminée, bloquant ainsi le thread appelant. L'implémentation par défaut retourne une tâche annulée si un jeton d'annulation déjà annulé est passé. Les exceptions levées par ExecuteReader sont communiquées via la propriété d'exception de tâche retournée. Cette méthode accepte un jeton d'annulation qui peut être utilisé pour demander l'annulation de l'opération plus tôt que prévu. Les implémentations peuvent ignorer cette demande.
ExecuteNonQuery()	Exécute le lot sur son objet de connexion, en retournant le nombre total de lignes affectées sur toutes les commandes de lot.
ExecuteNonQueryAsync(CancellationToken)	Il s'agit de la version asynchrone de ExecuteNonQuery(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le jeton d'annulation peut éventuellement être ignoré. L'implémentation par défaut appelle la méthode ExecuteNonQuery() synchrone et retourne une tâche terminée, bloquant ainsi le thread appelant. L'implémentation par défaut retourne une tâche annulée si un jeton d'annulation déjà annulé est passé. Les exceptions levées par ExecuteNonQuery() sont communiquées via la propriété d'exception de tâche retournée. N'appelle pas d'autres méthodes et propriétés de l'objet DbCommand jusqu'à ce que la tâche retournée soit terminée.
ExecuteReader(CommandBehavior)	Exécute le lot sur sa connexion, en retournant un DbDataReader qui peut être utilisé pour accéder aux résultats.
ExecuteReaderAsync(CancellationToken)	Version asynchrone de ExecuteReader, qui exécute le lot sur sa connexion, retournant un DbDataReader qui peut être utilisé pour accéder aux résultats.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Version asynchrone de ExecuteReader, qui exécute le lot sur sa connexion, retournant un DbDataReader qui peut être utilisé pour accéder aux résultats.
ExecuteScalar()	Exécute le lot et retourne la première colonne de la première ligne du premier jeu de résultats retourné. Toutes les autres colonnes, lignes et jeux de résultats sont ignorés.
ExecuteScalarAsync(CancellationToken)	Version asynchrone de ExecuteScalar(), qui exécute le lot et retourne la première colonne de la première ligne du premier jeu de résultats retourné. Toutes les autres colonnes, lignes et jeux de résultats sont ignorés.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
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)
Prepare()	Crée une version préparée (ou compilée) du lot, ou de chacune de ses commandes, sur la source de données.
PrepareAsync(CancellationToken)	Crée de manière asynchrone une version préparée (ou compilée) du lot, ou de chacune de ses commandes, sur la source de données.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Méthodes d’extension

ConfigureAwait(IAsyncDisposable, Boolean)

Configure la façon dont les attentes sur les tâches retournées à partir d’un élément supprimable asynchrone sont effectuées.