OdbcCommandBuilder Classe

Définition

Génère automatiquement des commandes de table unique utilisées pour répercuter les modifications apportées à DataSet dans la source de données associée. Cette classe ne peut pas être héritée.

public ref class OdbcCommandBuilder sealed : System::Data::Common::DbCommandBuilder
public ref class OdbcCommandBuilder sealed : System::ComponentModel::Component
public sealed class OdbcCommandBuilder : System.Data.Common.DbCommandBuilder
public sealed class OdbcCommandBuilder : System.ComponentModel.Component
type OdbcCommandBuilder = class
    inherit DbCommandBuilder
type OdbcCommandBuilder = class
    inherit Component
Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder
Public NotInheritable Class OdbcCommandBuilder
Inherits Component
Héritage
Héritage
OdbcCommandBuilder

Exemples

L’exemple suivant utilise OdbcCommand, avec OdbcDataAdapter et OdbcConnectionpour sélectionner des lignes à partir d’une source de données. L’exemple est passé un initialisé DataSet, un chaîne de connexion, une chaîne de requête qui est une instruction SQL SELECT et une chaîne qui est le nom de la table de source de données. L’exemple crée ensuite un OdbcCommandBuilder.

public static DataSet SelectOdbcSrvRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter = new OdbcDataAdapter();
        adapter.SelectCommand =
            new OdbcCommand(queryString, connection);
        OdbcCommandBuilder builder =
            new OdbcCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        //Without the OdbcCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);
    }
    return dataSet;
}
Public Function SelectOdbcSrvRows( _
    ByVal connectionString As String, ByVal queryString As String, _
    ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter()
        adapter.SelectCommand = _
            New OdbcCommand(queryString, connection)
        Dim builder As New OdbcCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        ' Without the OdbcCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)
    End Using

    Return dataSet
End Function

Remarques

ne OdbcDataAdapter génère pas automatiquement les instructions SQL requises pour rapprocher les modifications apportées à un DataSet associé à la source de données. Toutefois, vous pouvez créer un OdbcCommandBuilder objet qui génère des instructions SQL pour les mises à jour d’une table unique en définissant la SelectCommand propriété du OdbcDataAdapter. Génère OdbcCommandBuilder ensuite toutes les instructions SQL supplémentaires que vous ne définissez pas.

La relation entre un OdbcDataAdapter et son correspondant OdbcCommandBuilder est toujours un-à-un. Pour créer cette correspondance, vous définissez la OdbcDataAdapter propriété de l’objet OdbcCommandBuilder . Ainsi, le OdbcCommandBuilder s’inscrit lui-même en tant qu’écouteur, ce qui produit la sortie des RowUpdating événements qui affectent le DataSet.

Pour générer des instructions INSERT, UPDATE ou DELETE, utilise OdbcCommandBuilder la SelectCommand propriété pour récupérer un ensemble de métadonnées requis. Si vous modifiez la valeur de SelectCommand une 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.

Notes

Si l’instruction SELECT affectée à la SelectCommand propriété utilise des noms de colonnes avec alias, les instructions INSERT, UPDATE et DELETE obtenues peuvent être inexactes ou échouer. Si le pilote ODBC sous-jacent ne peut pas fournir le nom de colonne de base approprié pour le nom de colonne d’alias (en utilisant la valeur SQL_DESC_BASE_COLUMN_NAME de ), le nom de SQLColAttributel’alias peut être utilisé dans les instructions INSERT, UPDATE et DELETE générées. Par exemple, le pilote Microsoft ODBC pour Oracle retourne le nom de l’alias comme nom de colonne de base. Par conséquent, les instructions INSERT, UPDATE et DELETE générées entraînent des erreurs.

utilise OdbcCommandBuilder é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 la valeur de la SelectCommand propriété elle-même est modifiée. Sinon, les InsertCommandpropriétés , UpdateCommandet DeleteCommand conservent leurs valeurs précédentes.

Si vous appelez Dispose, le OdbcCommandBuilder est dissocié de et OdbcDataAdapterles commandes générées ne sont plus utilisées.

Constructeurs

OdbcCommandBuilder()

Initialise une nouvelle instance de la classe OdbcCommandBuilder.

OdbcCommandBuilder(OdbcDataAdapter)

Initialise une nouvelle instance de la classe OdbcCommandBuilder avec l'objet OdbcDataAdapter 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 l'objet OdbcDataAdapter pour lequel cet objet OdbcCommandBuilder générera des instructions SQL.

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 quand sont utilisés des objets de base de données (par exemple, des tables ou des colonnes) dont les noms contiennent des caractères comme 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 quand sont utilisés des objets de base de données (par exemple, des tables ou des colonnes) dont les noms contiennent des caractères comme 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(OdbcCommand)

Récupère les informations sur les paramètres à partir de la procédure stockée spécifiée dans OdbcCommand et remplit la collection Parameters de l'objet OdbcCommand 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 OdbcCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la source de données.

GetDeleteCommand(Boolean)

Obtient l'objet OdbcCommand 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 OdbcCommand généré automatiquement, qui est requis pour effectuer des insertions au niveau de la source de données.

GetInsertCommand(Boolean)

Obtient l'objet OdbcCommand 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 de @p#. Utilisez-le lors de la création d'un générateur de commandes personnalisé.

(Hérité de DbCommandBuilder)
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 OdbcCommand 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 OdbcCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la source de données.

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, OdbcConnection)

À 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 OdbcCommandBuilder.

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, OdbcConnection)

Étant donné un identificateur entre guillemets, retourne la forme sans guillemets correcte de cet identificateur, notamment en plaçant correctement hors d'une séquence d'échappement les guillemets incorporés dans l'identificateur.

UnquoteIdentifier(String)

Étant donné un identificateur entre guillemets, retourne la forme sans guillemets correcte de cet identificateur, notamment en plaçant correctement hors d'une séquence d'échappement 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)

S’applique à

Voir aussi