OleDbCommandBuilder Classe

Définition

Espace de noms:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Paquet:

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

Source:

OleDbCommandBuilder.cs

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

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

Héritage

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

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

Les OleDbDataAdapter 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 OleDbCommandBuilder objet pour générer automatiquement des instructions SQL pour les mises à jour à table unique si vous définissez la SelectCommand propriété du OleDbDataAdapter. Ensuite, toutes les instructions SQL supplémentaires que vous ne définissez pas sont générées par le OleDbCommandBuilder.

Il 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 ou OleDbCommandBuilder un seul objet entre eux à la fois.

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

Il OleDbCommandBuilder 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 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 DisposeOleDbCommandBuilder est dissocié du OleDbDataAdaptercode et les commandes générées ne sont plus utilisées.

Constructeurs

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

Propriétés

Nom	Description
DataAdapter	Obtient ou définit un OleDbDataAdapter objet pour lequel les instructions SQL sont générées automatiquement.

Méthodes

Nom	Description
DeriveParameters(OleDbCommand)	Récupère les informations de paramètre de la procédure stockée spécifiée dans le OleDbCommand fichier et remplit la Parameters collection de l’objet spécifié OleDbCommand .
GetDeleteCommand()	Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des suppressions à la source de données.
GetDeleteCommand(Boolean)	Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des suppressions à la source de données.
GetInsertCommand()	Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des insertions à la source de données.
GetInsertCommand(Boolean)	Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des insertions à la source de données.
GetUpdateCommand()	Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des mises à jour à la source de données.
GetUpdateCommand(Boolean)	Obtient l’objet généré OleDbCommand automatiquement requis pour effectuer des mises à jour à la source de données, éventuellement à l’aide de colonnes pour les noms de paramètres.
QuoteIdentifier(String, OleDbConnection)	É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, OleDbConnection)	En fonction d’un identificateur entre guillemets, retourne la forme non mise en guillemet correcte de cet identificateur. Cela inclut l’échappement correct des guillemets incorporés dans l’identificateur.
UnquoteIdentifier(String)	En fonction d’un identificateur entre guillemets, retourne la forme non mise en guillemet correcte de cet identificateur. Cela inclut l’échappement correct des guillemets incorporés dans l’identificateur.

Voir aussi

• Génération de commandes avec CommandBuilders