OleDbCommandBuilder Classe

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacchetto:

System.Data.OleDb v8.0.0

Source:

OleDbCommandBuilder.cs

Genera automaticamente comandi di tabella singola utilizzati per risolvere le modifiche apportate a una classe DataSet con il database associato. La classe non può essere ereditata.

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

Ereditarietà

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

Esempio

Nell'esempio seguente viene usato , OleDbCommandinsieme OleDbDataAdapter a e OleDbConnection, per selezionare le righe da un'origine dati. Nell'esempio viene passato un oggetto inizializzato DataSet, un stringa di connessione, una stringa di query che è un'istruzione SQL SELECT e una stringa che rappresenta il nome della tabella dell'origine dati. L'esempio crea quindi un oggetto 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

Commenti

Non OleDbDataAdapter genera automaticamente le istruzioni SQL necessarie per riconciliare le modifiche apportate a un DataSet oggetto con l'origine dati associata. Tuttavia, è possibile creare un OleDbCommandBuilder oggetto per generare automaticamente istruzioni SQL per gli aggiornamenti a tabella singola se si imposta la SelectCommand proprietà di OleDbDataAdapter. Tutte le istruzioni SQL aggiuntive non impostate vengono quindi generate da OleDbCommandBuilder.

Viene OleDbCommandBuilder registrato come listener per RowUpdating gli eventi ogni volta che si imposta la DataAdapter proprietà . È possibile associare uno o OleDbCommandBuilder un OleDbDataAdapter oggetto l'uno all'altro alla volta.

Per generare istruzioni INSERT, UPDATE o DELETE, viene OleDbCommandBuilder utilizzata la SelectCommand proprietà per recuperare automaticamente un set di metadati richiesto. Se si modifica dopo SelectCommand il recupero dei metadati, ad esempio dopo il primo aggiornamento, è necessario chiamare il RefreshSchema metodo per aggiornare i metadati.

Vengono OleDbCommandBuilder inoltre utilizzate le Connectionproprietà , CommandTimeoute Transaction a cui fa riferimento l'oggetto SelectCommand. L'utente deve chiamare RefreshSchema se una o più di queste proprietà vengono modificate o se la SelectCommand stessa proprietà viene sostituita. In caso contrario, le InsertCommandproprietà , UpdateCommande DeleteCommand mantengono i valori precedenti.

Se si chiama Dispose, l'oggetto OleDbCommandBuilder viene disassociato da OleDbDataAdaptere i comandi generati non vengono più usati.

Costruttori

OleDbCommandBuilder()	Inizializza una nuova istanza della classe OleDbCommandBuilder.
OleDbCommandBuilder(OleDbDataAdapter)	Inizializza una nuova istanza della classe OleDbCommandBuilder con l'oggetto OleDbDataAdapter associato.

Proprietà

CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
CatalogLocation	Ottiene o imposta il valore CatalogLocation per un'istanza della classe DbCommandBuilder. (Ereditato da DbCommandBuilder)
CatalogSeparator	Ottiene o imposta una stringa usata come separatore di catalogo per un'istanza della classe DbCommandBuilder. (Ereditato da DbCommandBuilder)
ConflictOption	Specifica quale enumerazione ConflictOption deve essere utilizzata dalla classe DbCommandBuilder. (Ereditato da DbCommandBuilder)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DataAdapter	Ottiene o imposta un oggetto OleDbDataAdapter per il quale sono generate automaticamente istruzioni SQL.
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
QuotePrefix	Ottiene o imposta il carattere o i caratteri iniziali da utilizzare quando si specificano oggetti di database, ad esempio tabelle o colonne, i cui nomi contengono caratteri quali spazi o token riservati. (Ereditato da DbCommandBuilder)
QuoteSuffix	Ottiene o imposta il carattere o i caratteri finali da utilizzare quando si specificano oggetti di database, ad esempio tabelle o colonne, i cui nomi contengono caratteri quali spazi o token riservati. (Ereditato da DbCommandBuilder)
SchemaSeparator	Ottiene o imposta il carattere da utilizzare come separatore tra l'identificatore di schema e altri identificatori. (Ereditato da DbCommandBuilder)
SetAllValues	Specifica se in un'istruzione di aggiornamento sono inclusi tutti i valori delle colonne o soltanto quelli modificati. (Ereditato da DbCommandBuilder)
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)

Metodi

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Attiva l'implementazione del provider per la classe DbCommandBuilder per consentire la gestione di proprietà aggiuntive dei parametri. (Ereditato da DbCommandBuilder)
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
DeriveParameters(OleDbCommand)	Recupera le informazioni sui parametri dalla stored procedure specificata nella classe OleDbCommand e compila l'insieme Parameters dell'oggetto OleDbCommand specificato.
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DbCommandBuilder e, facoltativamente, le risorse gestite. (Ereditato da DbCommandBuilder)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetDeleteCommand()	Ottiene l'oggetto OleDbCommand generato automaticamente, richiesto per eseguire le operazioni di eliminazione nell'origine dati.
GetDeleteCommand(Boolean)	Ottiene l'oggetto OleDbCommand generato automaticamente, richiesto per eseguire le operazioni di eliminazione nell'origine dati.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetInsertCommand()	Ottiene l'oggetto OleDbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.
GetInsertCommand(Boolean)	Ottiene l'oggetto OleDbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetParameterName(Int32)	Restituisce il nome del parametro specificato nel formato .@p# Da utilizzare quando si compila un generatore di comandi personalizzato. (Ereditato da DbCommandBuilder)
GetParameterName(String)	Restituisce il nome completo del parametro, dato il suo nome parziale. (Ereditato da DbCommandBuilder)
GetParameterPlaceholder(Int32)	Restituisce il segnaposto del parametro nell'istruzione SQL associata. (Ereditato da DbCommandBuilder)
GetSchemaTable(DbCommand)	Restituisce la tabella dello schema della classe DbCommandBuilder. (Ereditato da DbCommandBuilder)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUpdateCommand()	Ottiene l'oggetto OleDbCommand generato automaticamente richiesto per eseguire le operazioni di aggiornamento nell'origine dati.
GetUpdateCommand(Boolean)	Ottiene l'oggetto OleDbCommand generato automaticamente, richiesto per eseguire le operazioni di aggiornamento nell'origine dati, eventualmente utilizzando le colonne per i nomi dei parametri.
InitializeCommand(DbCommand)	Reimposta le proprietà CommandTimeout, Transaction, CommandType e UpdateRowSource sul valore DbCommand. (Ereditato da DbCommandBuilder)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
QuoteIdentifier(String)	Un identificatore senza virgolette con la lettera maiuscola o minuscola corretta per il catalogo, restituisce il form con virgolette corretto dell'identificatore. Ciò implica il sottoporre a escape in modo corretto eventuali virgolette nell'identificatore.
QuoteIdentifier(String, OleDbConnection)	Un identificatore senza virgolette con la lettera maiuscola o minuscola corretta per il catalogo, restituisce il form con virgolette corretto dell'identificatore. Ciò implica il sottoporre a escape in modo corretto eventuali virgolette nell'identificatore.
RefreshSchema()	Elimina i comandi associati all'oggetto DbCommandBuilder. (Ereditato da DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Aggiunge un gestore eventi per l'evento RowUpdating. (Ereditato da DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Registra l'oggetto DbCommandBuilder per gestire l'evento RowUpdating per un oggetto DbDataAdapter. (Ereditato da DbCommandBuilder)
ToString()	Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)
UnquoteIdentifier(String)	Un identificatore con virgolette, restituisce il form senza virgolette corretto relativo all'identificatore. Ciò implica il non sottoporre a escape in modo corretto eventuali virgolette nell'identificatore.
UnquoteIdentifier(String, OleDbConnection)	Un identificatore con virgolette, restituisce il form senza virgolette corretto relativo all'identificatore. Ciò implica il non sottoporre a escape in modo corretto eventuali virgolette nell'identificatore.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)

Vedi anche

• Generazione di comandi tramite CommandBuilders