DbCommandBuilder Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Génère automatiquement des commandes à table unique utilisées pour rapprocher les modifications apportées à une DataSet base de données associée. Il s’agit d’une classe abstraite qui ne peut être héritée que.
public ref class DbCommandBuilder abstract : System::ComponentModel::Componentpublic abstract class DbCommandBuilder : System.ComponentModel.Componenttype DbCommandBuilder = class
inherit ComponentPublic MustInherit Class DbCommandBuilder
Inherits Component- Héritage
- Dérivé
Remarques
La DbCommandBuilder classe est fournie pour la commodité des enregistreurs 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.
Les DbDataAdapter instructions SQL ne sont pas générées automatiquement pour rapprocher les modifications apportées à une DataSet 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 à table unique si vous définissez la SelectCommand propriété du DbDataAdapter. Ensuite, toutes les instructions SQL supplémentaires que vous ne définissez pas sont générées par le DbCommandBuilder.
Il 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 ou DbCommandBuilder un seul objet entre eux à la fois.
Pour générer des instructions INSERT, UPDATE ou DELETE, la DbCommandBuilder propriété utilise la SelectCommand propriété pour récupérer automatiquement un ensemble de métadonnées requis. Si vous modifiez une SelectCommand fois les métadonnées 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. Si aucune exception n’existe, une InvalidOperationException exception est générée et les commandes ne sont pas générées.
Il DbCommandBuilder utilise é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 elle SelectCommand est remplacée. Sinon, les InsertCommandpropriétés et DeleteCommand les UpdateCommandpropriétés conservent leurs valeurs précédentes.
Si vous appelez , l’objet DisposeDbCommandBuilder est dissocié du DbDataAdaptercode et les commandes générées ne sont plus utilisées.
Constructeurs
| Nom | Description |
|---|---|
| DbCommandBuilder() |
Initialise une nouvelle instance d’une classe qui hérite de la DbCommandBuilder classe. |
Propriétés
| Nom | Description |
|---|---|
| CanRaiseEvents |
Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component) |
| CatalogLocation |
Obtient ou définit la CatalogLocation valeur d’une instance de la DbCommandBuilder classe. |
| CatalogSeparator |
Obtient ou définit une chaîne utilisée comme séparateur de catalogue pour une instance de la DbCommandBuilder classe. |
| ConflictOption |
Spécifie qui ConflictOption doit être utilisé par le DbCommandBuilder. |
| Container |
Obtient le IContainer fichier qui contient le Component. (Hérité de Component) |
| DataAdapter |
Obtient ou définit un DbDataAdapter objet pour lequel les instructions Transact-SQL sont générées automatiquement. |
| DesignMode |
Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component) |
| Events |
Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component. (Hérité de Component) |
| QuotePrefix |
Obtient ou définit le caractère de début ou les caractères à utiliser lors de la spécification d’objets de base de données (par exemple, des tables ou des colonnes) dont les noms contiennent des caractères tels que des espaces ou des jetons réservés. |
| QuoteSuffix |
Obtient ou définit le caractère de fin ou les caractères à utiliser lors de la spécification d’objets de base de données (par exemple, des tables ou des 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 tous les autres identificateurs. |
| SetAllValues |
Spécifie si toutes les valeurs de colonne d’une instruction de mise à jour sont incluses ou modifiées uniquement. |
| Site |
Obtient ou définit le ISiteComponent. (Hérité de Component) |
Méthodes
| Nom | Description |
|---|---|
| ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean) |
Permet à l’implémentation du fournisseur de la DbCommandBuilder classe de gérer des propriétés de paramètre supplémentaires. |
| CreateObjRef(Type) |
Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| Dispose() |
Libère toutes les ressources utilisées par le Component. (Hérité de Component) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les DbCommandBuilder ressources gérées 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 généré DbCommand automatiquement requis pour effectuer des suppressions à la source de données. |
| GetDeleteCommand(Boolean) |
Obtient l’objet généré DbCommand automatiquement nécessaire pour effectuer des suppressions à la source de données, éventuellement à l’aide de colonnes pour les noms de paramètres. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetInsertCommand() |
Obtient l’objet généré DbCommand automatiquement requis pour effectuer des insertions à la source de données. |
| GetInsertCommand(Boolean) |
Obtient l’objet généré DbCommand automatiquement requis pour effectuer des insertions à la source de données, éventuellement à l’aide de colonnes pour les noms de paramètres. |
| GetLifetimeService() |
Obsolète.
Récupère l’objet de service de durée de vie actuel 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 . |
| GetParameterName(String) |
Retourne le nom complet du paramètre, en fonction du nom du 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 le Component ou par son Container. (Hérité de Component) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| GetUpdateCommand() |
Obtient l’objet généré DbCommand automatiquement requis pour effectuer des mises à jour à la source de données. |
| GetUpdateCommand(Boolean) |
Obtient l’objet généré DbCommand automatiquement requis pour effectuer des mises à jour à la source de données, éventuellement à l’aide de colonnes pour les noms de paramètres. |
| InitializeCommand(DbCommand) |
Réinitialise les CommandTimeoutpropriétés , Transactionet CommandTypeUpdateRowSource les propriétés sur le 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 Objectactuel. (Hérité de Object) |
| MemberwiseClone(Boolean) |
Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject) |
| QuoteIdentifier(String) |
Étant donné un identificateur non cité dans le cas de catalogue correct, retourne la forme entre guillemets correcte de cet identificateur, y compris l’échappement correct 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) |
Inscrit le DbCommandBuilder pour gérer l’événement RowUpdating pour un DbDataAdapter. |
| ToString() |
Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component) |
| UnquoteIdentifier(String) |
Étant donné un identificateur entre guillemets, retourne la forme non mise en guillemet correcte de cet identificateur, y compris l’échappement correct des guillemets incorporés dans l’identificateur. |
Événements
| Nom | Description |
|---|---|
| Disposed |
Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component) |
