DbBatch Classe

Définition

Représente un lot de commandes qui peuvent être exécutées sur une source de données dans 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
DbBatch
Implémente

Remarques

La sémantique précise de l’exécution de lots varie entre les fournisseurs ADO.NET, en particulier autour de la gestion des erreurs. Si possible, il est recommandé qu’une erreur dans une commande dans le lot termine immédiatement le lot, ignore toutes les commandes suivantes et restaure les commandes qui ont déjà été 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 la DbConnection utilisée par cette 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 substitution 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 terminer la tentative d’exécution du lot et de générer une erreur.

Transaction

Obtient ou définit la DbTransaction dans laquelle cet objet DbBatch s’exécute.

Méthodes

Cancel()

Tente d’annuler l’exécution d’un DbBatch.

CreateBatchCommand()

Crée une 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()

Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation 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 par rapport à sa connexion, retournant une DbDataReader qui peut être utilisée pour accéder aux résultats.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Les fournisseurs doivent implémenter cette méthode pour fournir une implémentation non par défaut pour ExecuteReader surcharges.

L’implémentation par défaut appelle la méthode de ExecuteReader() synchrone et retourne une tâche terminée, bloquant le thread appelant. L’implémentation par défaut retourne une tâche annulée si elle a passé un jeton d’annulation déjà annulé. Les exceptions levées par ExecuteReader sont communiquées via la propriété Exception de tâche retournée.

Cette méthode accepte un jeton d’annulation qui peut être utilisé pour demander l’annulation anticipée de l’opération. 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 remplacer par une implémentation appropriée. Le jeton d’annulation peut éventuellement être ignoré.

L’implémentation par défaut appelle la méthode de ExecuteNonQuery() synchrone et retourne une tâche terminée, bloquant le thread appelant. L’implémentation par défaut retourne une tâche annulée si elle a passé un jeton d’annulation déjà annulé. Les exceptions levées par ExecuteNonQuery() sont communiquées via la propriété Exception de tâche retournée.

N’appelez pas d’autres méthodes et propriétés de l’objet DbCommand tant que la tâche retournée n’est pas terminée.

ExecuteReader(CommandBehavior)

Exécute le lot par rapport à sa connexion, retournant une DbDataReader qui peut être utilisée pour accéder aux résultats.

ExecuteReaderAsync(CancellationToken)

Version asynchrone de ExecuteReader, qui exécute le lot sur sa connexion, retournant une DbDataReader qui peut être utilisée pour accéder aux résultats.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Version asynchrone de ExecuteReader, qui exécute le lot sur sa connexion, retournant une DbDataReader qui peut être utilisée 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()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(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 façon 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 jetable asynchrone sont effectuées.

S’applique à