OleDbCommandBuilder 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 de table simple utilisées pour harmoniser les modifications apportées à DataSet avec la base de données associée. Cette classe ne peut pas être héritée.
public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilderpublic ref class OleDbCommandBuilder sealed : System::ComponentModel::Componentpublic sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilderpublic sealed class OleDbCommandBuilder : System.ComponentModel.Componenttype OleDbCommandBuilder = class
inherit DbCommandBuildertype OleDbCommandBuilder = class
inherit ComponentPublic NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilderPublic NotInheritable Class OleDbCommandBuilder
Inherits Component- Héritage
- Héritage
Exemples
L’exemple suivant utilise , OleDbCommandle long OleDbDataAdapter et OleDbConnection, pour sélectionner des lignes à partir d’une source de données. L’exemple est passé un chaîne de connexion initialiséDataSet, une chaîne de requête qui est une instruction SELECT SQL et une chaîne qui est le nom de la table de source de données. L’exemple crée ensuite un OleDbCommandBuilder.
public static DataSet UpdateRows(string connectionString,
string queryString, string tableName)
{
DataSet dataSet = new DataSet();
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbDataAdapter adapter = new OleDbDataAdapter();
adapter.SelectCommand = new OleDbCommand(queryString, connection);
OleDbCommandBuilder cb = new OleDbCommandBuilder(adapter);
connection.Open();
adapter.Fill(dataSet, tableName);
//code to modify data in DataSet here
cb.GetDeleteCommand();
//Without the OleDbCommandBuilder this line would fail
adapter.Update(dataSet, tableName);
connection.Close();
}
return dataSet;
}
Public Shared Function UpdateRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet
Dim dataSet As New DataSet()
Using connection As New OleDbConnection(connectionString)
Dim adapter As New OleDbDataAdapter()
adapter.SelectCommand = New OleDbCommand(queryString, connection)
Dim builder As New OleDbCommandBuilder(adapter)
connection.Open()
adapter.Fill(dataSet, tableName)
' Code to modify data in DataSet here
builder.GetUpdateCommand()
' Without the OleDbCommandBuilder this line would fail.
adapter.Update(dataSet, tableName)
End Using
Return dataSet
End Function
Remarques
ne OleDbDataAdapter 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 OleDbCommandBuilder 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 .OleDbDataAdapter Ensuite, toutes les instructions SQL supplémentaires que vous ne définissez pas sont générées par .OleDbCommandBuilder
Le OleDbCommandBuilder 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 OleDbDataAdapter seul objet ou OleDbCommandBuilder l’un à l’autre à la fois.
Pour générer des instructions INSERT, UPDATE ou DELETE, le OleDbCommandBuilder utilise la SelectCommand propriété pour récupérer automatiquement un ensemble de métadonnées requis. Si vous modifiez le SelectCommand après la récupération des métadonnées, par exemple après la première mise à jour, vous devez appeler la RefreshSchema méthode pour mettre à jour les métadonnées.
utilise OleDbCommandBuilder également les Connectionpropriétés , CommandTimeoutet Transaction référencées par le SelectCommand. L’utilisateur doit appeler RefreshSchema si une ou plusieurs de ces propriétés sont modifiées 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 OleDbCommandBuilder est dissocié du OleDbDataAdapteret les commandes générées ne sont plus utilisées.
Constructeurs
| OleDbCommandBuilder() |
Initialise une nouvelle instance de la classe OleDbCommandBuilder. |
| OleDbCommandBuilder(OleDbDataAdapter) |
Initialise une nouvelle instance de la classe OleDbCommandBuilder avec l'objet OleDbDataAdapter associé. |
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. (Hérité de DbCommandBuilder) |
| CatalogSeparator |
Obtient ou définit une chaîne utilisée comme séparateur de catalogue pour une instance de la classe DbCommandBuilder. (Hérité de DbCommandBuilder) |
| ConflictOption |
Spécifie quel ConflictOption doit être utilisé par le DbCommandBuilder. (Hérité de DbCommandBuilder) |
| Container |
Obtient le IContainer qui contient la Component. (Hérité de Component) |
| DataAdapter |
Obtient ou définit un objet OleDbDataAdapter pour lequel les instructions 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. |
| 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. (Hérité de DbCommandBuilder) |
| 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. |
| 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. (Hérité de DbCommandBuilder) |
| SchemaSeparator |
Obtient ou définit le caractère à utiliser pour le séparateur entre l'identificateur de schéma et tout autre identificateur. (Hérité de DbCommandBuilder) |
| SetAllValues |
Spécifie si toutes les valeurs de colonne d'une instruction de mise à jour sont incluses ou uniquement modifiées. (Hérité de DbCommandBuilder) |
| 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. (Hérité de DbCommandBuilder) |
| 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) |
| DeriveParameters(OleDbCommand) |
Récupère les informations sur les paramètres à partir de la procédure stockée spécifiée dans OleDbCommand et remplit la collection Parameters de l'objet OleDbCommand spécifié. |
| 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. (Hérité de DbCommandBuilder) |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component) |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetDeleteCommand() |
Obtient l'objet OleDbCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la source de données. |
| GetDeleteCommand(Boolean) |
Obtient l'objet OleDbCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la source de données. |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetInsertCommand() |
Obtient l'objet OleDbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données. |
| GetInsertCommand(Boolean) |
Obtient l'objet OleDbCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données. |
| 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 . |
| GetParameterName(String) |
Retourne le nom de paramètre complet à partir du nom de paramètre partiel. (Hérité de DbCommandBuilder) |
| GetParameterPlaceholder(Int32) |
Retourne l'espace réservé pour le paramètre dans l'instruction SQL associée. (Hérité de DbCommandBuilder) |
| GetSchemaTable(DbCommand) |
Retourne la table de schéma pour le DbCommandBuilder. (Hérité de 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 OleDbCommand 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 OleDbCommand 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. (Hérité de DbCommandBuilder) |
| 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, OleDbConnection) |
À partir d'un identificateur sans guillemets dans le cas d'un catalogue correct, retourne la forme correcte de cet identificateur entre guillemets. Cela inclut d'effectuer une séquence d'échappement correcte pour les guillemets incorporés dans l'identificateur. |
| QuoteIdentifier(String) |
À partir d'un identificateur sans guillemets dans le cas d'un catalogue correct, retourne la forme correcte de cet identificateur entre guillemets. Cela inclut d'effectuer une séquence d'échappement correcte pour les guillemets incorporés dans l'identificateur. |
| RefreshSchema() |
Efface les commandes associées à ce OleDbCommandBuilder. |
| RefreshSchema() |
Efface les commandes associées à ce DbCommandBuilder. (Hérité de DbCommandBuilder) |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Ajoute un gestionnaire d'événements pour l'événement RowUpdating. (Hérité de DbCommandBuilder) |
| SetRowUpdatingHandler(DbDataAdapter) |
Enregistre le DbCommandBuilder pour gérer l'événement RowUpdating d'un DbDataAdapter. (Hérité de DbCommandBuilder) |
| 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, OleDbConnection) |
Muni d'un identificateur entre guillemets, retourne la forme de cet identificateur sans guillemets. Cela inclut d'effectuer une annulation de séquence d'échappement correcte pour les guillemets incorporés dans l'identificateur. |
| UnquoteIdentifier(String) |
Muni d'un identificateur entre guillemets, retourne la forme de cet identificateur sans guillemets. Cela inclut d'effectuer une annulation de séquence d'échappement correcte pour les 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) |
