DbCommandBuilder Classe

Définition

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.Automatically generates single-table commands used to reconcile changes made to a DataSet with the associated database. Cette classe est une classe abstraite qui peut uniquement être héritée.This is an abstract class that can only be inherited.

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
Dérivé

Remarques

La classe DbCommandBuilder est fournie pour la commodité des writers de fournisseurs qui créent leurs propres générateurs de commandes.The DbCommandBuilder class is provided for the convenience of provider writers creating their own command builders. En héritant de cette classe, les développeurs peuvent implémenter un comportement spécifique au fournisseur dans leur propre code.By inheriting from this class, developers can implement provider specific behavior in their own code.

Le DbDataAdapter ne génère pas automatiquement les instructions SQL requises pour harmoniser les modifications apportées à un DataSet avec la source de données associée.The DbDataAdapter does not automatically generate the SQL statements required to reconcile changes made to a DataSet with the associated data source. Toutefois, vous pouvez créer un objet DbCommandBuilder pour générer automatiquement des instructions SQL pour les mises à jour d’une seule table si vous définissez la propriété SelectCommand de l' DbDataAdapter.However, you can create a DbCommandBuilder object to automatically generate SQL statements for single-table updates if you set the SelectCommand property of the DbDataAdapter. Ensuite, toutes les instructions SQL supplémentaires que vous ne définissez pas sont générées par la DbCommandBuilder.Then, any additional SQL statements that you do not set are generated by the DbCommandBuilder.

L' DbCommandBuilder s’inscrit comme un écouteur pour les événements RowUpdating chaque fois que vous définissez la propriété DataAdapter.The DbCommandBuilder registers itself as a listener for RowUpdating events whenever you set the DataAdapter property. Vous ne pouvez associer qu’un seul objet DbDataAdapter ou DbCommandBuilder entre eux en même temps.You can only associate one DbDataAdapter or DbCommandBuilder object with each other at one time.

Pour générer des instructions INSERT, UPDATE ou DELETE, l' DbCommandBuilder utilise la propriété SelectCommand pour récupérer automatiquement un jeu de métadonnées requis.To generate INSERT, UPDATE, or DELETE statements, the DbCommandBuilder uses the SelectCommand property to retrieve a required set of metadata automatically. Si vous modifiez la 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 méthode RefreshSchema pour mettre à jour les métadonnées.If you change the SelectCommand after the metadata has been retrieved (for example, after the first update), you should call the RefreshSchema method to update the metadata.

SelectCommand doit aussi retourner au moins une clé primaire ou une colonne unique.The SelectCommand must also return at least one primary key or unique column. Si aucune n’existe, une exception InvalidOperationException est générée et les commandes ne sont pas générées.If none exist, an InvalidOperationException exception is generated, and the commands are not generated.

Le DbCommandBuilder utilise également les propriétés Connection, CommandTimeoutet Transaction référencées par le SelectCommand.The DbCommandBuilder also uses the Connection, CommandTimeout, and Transaction properties referenced by the SelectCommand. L’utilisateur doit appeler RefreshSchema si l’une de ces propriétés est modifiée, ou si la SelectCommand elle-même est remplacée.The user should call RefreshSchema if any of these properties are modified, or if the SelectCommand itself is replaced. Dans le cas contraire, les propriétés InsertCommand, UpdateCommandet DeleteCommand conservent leurs valeurs précédentes.Otherwise the InsertCommand, UpdateCommand, and DeleteCommand properties retain their previous values.

Si vous appelez Dispose, la DbCommandBuilder est dissociée de la DbDataAdapteret les commandes générées ne sont plus utilisées.If you call Dispose, the DbCommandBuilder is disassociated from the DbDataAdapter, and the generated commands are no longer used.

Constructeurs

DbCommandBuilder()

Initialise une nouvelle instance d'une classe qui hérite de la classe DbCommandBuilder.Initializes a new instance of a class that inherits from the DbCommandBuilder class.

Propriétés

CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Hérité de Component)
CatalogLocation

Obtient ou définit le CatalogLocation d’une instance de la classe DbCommandBuilder.Gets or sets the CatalogLocation for an instance of the DbCommandBuilder class.

CatalogSeparator

Obtient ou définit une chaîne utilisée comme séparateur de catalogue pour une instance de la classe DbCommandBuilder.Gets or sets a string used as the catalog separator for an instance of the DbCommandBuilder class.

ConflictOption

Spécifie quel ConflictOption doit être utilisé par le DbCommandBuilder.Specifies which ConflictOption is to be used by the DbCommandBuilder.

Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the 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.Gets or sets a DbDataAdapter object for which Transact-SQL statements are automatically generated.

DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this 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.Gets or sets the beginning character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

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.Gets or sets the ending character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

SchemaSeparator

Obtient ou définit le caractère à utiliser pour le séparateur entre l'identificateur de schéma et tout autre identificateur.Gets or sets the character to be used for the separator between the schema identifier and any other identifiers.

SetAllValues

Spécifie si toutes les valeurs de colonne d'une instruction de mise à jour sont incluses ou uniquement modifiées.Specifies whether all column values in an update statement are included or only changed ones.

Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the 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.Allows the provider implementation of the DbCommandBuilder class to handle additional parameter properties.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the 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.Releases the unmanaged resources used by the DbCommandBuilder and optionally releases the managed resources.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(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.Gets the automatically generated DbCommand object required to perform deletions at the data source.

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.Gets the automatically generated DbCommand object required to perform deletions at the data source, optionally using columns for parameter names.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(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.Gets the automatically generated DbCommand object required to perform insertions at the data source.

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.Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetParameterName(Int32)

Retourne le nom du paramètre spécifié au format @p#.Returns the name of the specified parameter in the format of @p#. Utilisez-le lors de la création d'un générateur de commandes personnalisé.Use when building a custom command builder.

GetParameterName(String)

Retourne le nom de paramètre complet à partir du nom de paramètre partiel.Returns the full parameter name, given the partial parameter name.

GetParameterPlaceholder(Int32)

Retourne l'espace réservé pour le paramètre dans l'instruction SQL associée.Returns the placeholder for the parameter in the associated SQL statement.

GetSchemaTable(DbCommand)

Retourne la table de schéma pour le DbCommandBuilder.Returns the schema table for the DbCommandBuilder.

GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Hérité de Component)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(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.Gets the automatically generated DbCommand object required to perform updates at the data source.

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.Gets the automatically generated DbCommand object required to perform updates at the data source, optionally using columns for parameter names.

InitializeCommand(DbCommand)

Réinitialise les propriétés CommandTimeout, Transaction, CommandType et UpdateRowSource à la valeur DbCommand.Resets the CommandTimeout, Transaction, CommandType, and UpdateRowSource properties on the DbCommand.

InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(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.Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier, including properly escaping any embedded quotes in the identifier.

RefreshSchema()

Efface les commandes associées à ce DbCommandBuilder.Clears the commands associated with this DbCommandBuilder.

RowUpdatingHandler(RowUpdatingEventArgs)

Ajoute un gestionnaire d'événements pour l'événement RowUpdating.Adds an event handler for the RowUpdating event.

SetRowUpdatingHandler(DbDataAdapter)

Enregistre le DbCommandBuilder pour gérer l'événement RowUpdating d'un DbDataAdapter.Registers the DbCommandBuilder to handle the RowUpdating event for a DbDataAdapter.

ToString()

Retourne un String contenant le nom du Component, s’il en existe un.Returns a String containing the name of the Component, if any. Cette méthode ne doit pas être remplacée.This method should not be overridden.

(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.Given a quoted identifier, returns the correct unquoted form of that identifier, including properly un-escaping any embedded quotes in the identifier.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Hérité de Component)

S’applique à

Voir aussi