OdbcCommandBuilder Classe

Définition

Espace de noms:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paquet:

System.Data.Odbc v11.0.0-preview.2.26159.112

Source:

OdbcCommandBuilder.cs

Génère automatiquement des commandes à table unique utilisées pour rapprocher les modifications apportées à une DataSet 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 sealed class OdbcCommandBuilder : System.Data.Common.DbCommandBuilder

type OdbcCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder

Héritage

Object

MarshalByRefObject

Component

DbCommandBuilder

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é une chaîne de connexion initialisée DataSet, 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

L’instruction OdbcDataAdapter SQL ne génère pas automatiquement les instructions SQL nécessaires pour rapprocher les modifications apportées à une DataSet source de données associée. Toutefois, vous pouvez créer un OdbcCommandBuilder objet qui génère des instructions SQL pour les mises à jour à table unique en définissant la SelectCommand propriété de l’objet OdbcDataAdapter. Le OdbcCommandBuilder code génère 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 . Cela entraîne l’inscription OdbcCommandBuilder en tant qu’écouteur, qui produit la sortie des RowUpdating événements qui affectent le DataSet.

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

Note

Si l’instruction SELECT affectée à la SelectCommand propriété utilise des noms de colonnes 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 (à l’aide de la valeur SQL_DESC_BASE_COLUMN_NAME ), le nom de SQLColAttributel’alias peut être utilisé dans les instructions INSERT, UPDATE et DELETE générées. Par exemple, microsoft ODBC Driver for 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 provoquent des erreurs.

Il OdbcCommandBuilder utilise é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 et DeleteCommand les UpdateCommandpropriétés conservent leurs valeurs précédentes.

Si vous appelez , l’objet DisposeOdbcCommandBuilder est dissocié du OdbcDataAdaptercode et les commandes générées ne sont plus utilisées.

Constructeurs

Nom	Description
OdbcCommandBuilder()	Initialise une nouvelle instance de la classe OdbcCommandBuilder.
OdbcCommandBuilder(OdbcDataAdapter)	Initialise une nouvelle instance de la OdbcCommandBuilder classe avec l’objet associé OdbcDataAdapter .

Propriétés

Nom	Description
DataAdapter	Obtient ou définit un OdbcDataAdapter objet pour lequel cet OdbcCommandBuilder objet génère des instructions SQL.

Méthodes

Nom	Description
DeriveParameters(OdbcCommand)	Récupère les informations de paramètre de la procédure stockée spécifiée dans le OdbcCommand fichier et remplit la Parameters collection de l’objet spécifié OdbcCommand .
GetDeleteCommand()	Obtient l’objet généré OdbcCommand automatiquement requis pour effectuer des suppressions à la source de données.
GetDeleteCommand(Boolean)	Obtient l’objet généré OdbcCommand automatiquement requis pour effectuer des suppressions à la source de données.
GetInsertCommand()	Obtient l’objet généré OdbcCommand automatiquement requis pour effectuer des insertions à la source de données.
GetInsertCommand(Boolean)	Obtient l’objet généré OdbcCommand automatiquement requis pour effectuer des insertions à la source de données.
GetUpdateCommand()	Obtient l’objet généré OdbcCommand automatiquement requis pour effectuer des mises à jour à la source de données.
GetUpdateCommand(Boolean)	Obtient l’objet généré OdbcCommand automatiquement requis pour effectuer des mises à jour à la source de données.
QuoteIdentifier(String, OdbcConnection)	Étant donné un identificateur non cité dans le cas de catalogue correct, retourne la forme entre guillemets correcte de cet identificateur. Cela inclut l’échappement correct des guillemets incorporés dans l’identificateur.
QuoteIdentifier(String)	Étant donné un identificateur non cité dans le cas de catalogue correct, retourne la forme entre guillemets correcte de cet identificateur. Cela inclut l’échappement correct des guillemets incorporés dans l’identificateur.
UnquoteIdentifier(String, OdbcConnection)	Étant donné un identificateur entre guillemets, retourne la forme non mise en guillemet correcte de cet identificateur, y compris l’annulation correcte du regroupement des guillemets incorporés dans l’identificateur.
UnquoteIdentifier(String)	Étant donné un identificateur entre guillemets, retourne la forme non mise en guillemet correcte de cet identificateur, y compris l’annulation correcte du regroupement des guillemets incorporés dans l’identificateur.

Voir aussi

• Génération de commandes avec CommandBuilders