DbCommandBuilder Classe

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Génère automatiquement des commandes de table simple utilisées pour harmoniser les modifications apportées à DataSet avec la base de données associée. Cette classe est une classe abstraite qui peut uniquement être héritée.

public ref class DbCommandBuilder abstract : System::ComponentModel::Component

public abstract class DbCommandBuilder : System.ComponentModel.Component

type DbCommandBuilder = class
    inherit Component

Public MustInherit Class DbCommandBuilder
Inherits Component

Héritage

Object

MarshalByRefObject

Component

DbCommandBuilder

Dérivé

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

System.Data.SqlClient.SqlCommandBuilder

Remarques

La DbCommandBuilder classe est fournie pour la commodité des rédacteurs de fournisseurs qui créent leurs propres générateurs de commandes. En hériter de cette classe, les développeurs peuvent implémenter un comportement spécifique au fournisseur dans leur propre code.

ne DbDataAdapter génère pas automatiquement les instructions SQL nécessaires pour rapprocher les modifications apportées à un DataSet avec la source de données associée. Toutefois, vous pouvez créer un DbCommandBuilder objet pour générer automatiquement des instructions SQL pour les mises à jour d’une table unique si vous définissez la SelectCommand propriété de .DbDataAdapter Ensuite, toutes les instructions SQL supplémentaires que vous ne définissez pas sont générées par .DbCommandBuilder

Le DbCommandBuilder s’inscrit en tant qu’écouteur pour RowUpdating les événements chaque fois que vous définissez la DataAdapter propriété. Vous ne pouvez associer qu’un DbDataAdapter seul objet ou DbCommandBuilder l’un à l’autre à la fois.

Pour générer des instructions INSERT, UPDATE ou DELETE, le DbCommandBuilder utilise la SelectCommand propriété pour récupérer automatiquement un ensemble de métadonnées requis. Si vous modifiez le SelectCommand une fois que les métadonnées ont été récupérées (par exemple, après la première mise à jour), vous devez appeler la RefreshSchema méthode pour mettre à jour les métadonnées.

SelectCommand doit aussi retourner au moins une clé primaire ou une colonne unique. S’il n’en existe aucune, une InvalidOperationException exception est générée et les commandes ne sont pas générées.

utilise DbCommandBuilder également les Connectionpropriétés , CommandTimeoutet Transaction référencées par le SelectCommand. L’utilisateur doit appeler RefreshSchema si l’une de ces propriétés est modifiée ou si le SelectCommand lui-même est remplacé. Sinon, les InsertCommandpropriétés , UpdateCommandet DeleteCommand conservent leurs valeurs précédentes.

Si vous appelez Dispose, le DbCommandBuilder est dissocié du DbDataAdapteret les commandes générées ne sont plus utilisées.

Constructeurs

DbCommandBuilder()

Initialise une nouvelle instance d'une classe qui hérite de la classe DbCommandBuilder.

Propriétés

CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
CatalogLocation	Obtient ou définit le CatalogLocation d’une instance de la classe DbCommandBuilder.
CatalogSeparator	Obtient ou définit une chaîne utilisée comme séparateur de catalogue pour une instance de la classe DbCommandBuilder.
ConflictOption	Spécifie quel ConflictOption doit être utilisé par le DbCommandBuilder.
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
DataAdapter	Obtient ou définit un objet DbDataAdapter pour lequel les instructions Transact-SQL sont automatiquement générées.
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
QuotePrefix	Obtient ou définit le ou les caractères de début à utiliser lors de la spécification d'objets de base de données (par exemple, des tables ou colonnes) dont les noms contiennent des caractères tels que des espaces ou des jetons réservés.
QuoteSuffix	Obtient ou définit le ou les caractères de fin à utiliser lors de la spécification d'objets de base de données (par exemple, des tables ou colonnes) dont les noms contiennent des caractères tels que des espaces ou des jetons réservés.
SchemaSeparator	Obtient ou définit le caractère à utiliser pour le séparateur entre l'identificateur de schéma et tout autre identificateur.
SetAllValues	Spécifie si toutes les valeurs de colonne d'une instruction de mise à jour sont incluses ou uniquement modifiées.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)

Méthodes

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Permet à l'implémentation de fournisseur de la classe DbCommandBuilder de gérer des propriétés de paramètre supplémentaires.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par DbCommandBuilder et libère éventuellement les ressources managées.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetDeleteCommand()	Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la source de données.
GetDeleteCommand(Boolean)	Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la source de données, en utilisant éventuellement des colonnes pour les noms de paramètres.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetInsertCommand()	Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données.
GetInsertCommand(Boolean)	Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données, en utilisant éventuellement des colonnes pour les noms de paramètres.
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetParameterName(Int32)	Retourne le nom du paramètre spécifié au format .@p# Utilisez-le lors de la création d'un générateur de commandes personnalisé.
GetParameterName(String)	Retourne le nom de paramètre complet à partir du nom de paramètre partiel.
GetParameterPlaceholder(Int32)	Retourne l'espace réservé pour le paramètre dans l'instruction SQL associée.
GetSchemaTable(DbCommand)	Retourne la table de schéma pour le DbCommandBuilder.
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetUpdateCommand()	Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la source de données.
GetUpdateCommand(Boolean)	Obtient l'objet DbCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la source de données, en utilisant éventuellement des colonnes pour les noms de paramètres.
InitializeCommand(DbCommand)	Réinitialise les propriétés CommandTimeout, Transaction, CommandType et UpdateRowSource à la valeur DbCommand.
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
QuoteIdentifier(String)	À partir d'un identificateur sans guillemets dans le cas du catalogue correct, retourne le formulaire correct entre guillemets de cet identificateur, y compris une séquence d'échappement correcte des guillemets incorporés dans l'identificateur.
RefreshSchema()	Efface les commandes associées à ce DbCommandBuilder.
RowUpdatingHandler(RowUpdatingEventArgs)	Ajoute un gestionnaire d'événements pour l'événement RowUpdating.
SetRowUpdatingHandler(DbDataAdapter)	Enregistre le DbCommandBuilder pour gérer l'événement RowUpdating d'un DbDataAdapter.
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)
UnquoteIdentifier(String)	À partir d'un identificateur entre guillemets, retourne le formulaire correct sans guillemets de cet identificateur, y compris une séquence d'échappement correctement annulée de guillemets incorporés dans l'identificateur.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)

Voir aussi

• Génération de commandes avec CommandBuilders
• Vue d'ensemble d’ADO.NET