DbCommandBuilder Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DBCommandBuilder.cs

Genera automaticamente comandi di tabella singola per risolvere le modifiche apportate a un oggetto DataSet con il database associato. Si tratta di una classe astratta che può soltanto essere ereditata.

public ref class DbCommandBuilder abstract : System::ComponentModel::Component

public abstract class DbCommandBuilder : System.ComponentModel.Component

type DbCommandBuilder = class
    inherit Component

Public MustInherit Class DbCommandBuilder
Inherits Component

Ereditarietà

Object

MarshalByRefObject

Component

DbCommandBuilder

Derivato

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

System.Data.SqlClient.SqlCommandBuilder

Commenti

La DbCommandBuilder classe viene fornita per praticità dei writer del provider che creano i propri generatori di comandi. Ereditando da questa classe, gli sviluppatori possono implementare un comportamento specifico del provider nel proprio codice.

L'oggetto DbDataAdapter non genera automaticamente le istruzioni SQL necessarie per riconciliare le modifiche apportate a un DataSet con l'origine dati associata. È tuttavia possibile creare un DbCommandBuilder oggetto per generare automaticamente istruzioni SQL per gli aggiornamenti a tabella singola se si imposta la SelectCommand proprietà di DbDataAdapter. Eventuali istruzioni SQL aggiuntive che non sono impostate vengono quindi generate dall'oggetto DbCommandBuilder.

Si DbCommandBuilder registra come listener per RowUpdating gli eventi ogni volta che si imposta la DataAdapter proprietà. È possibile associare uno o DbCommandBuilder un oggetto l'uno DbDataAdapter all'altro alla volta.

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

È inoltre necessario che SelectCommand restituisca almeno una chiave primaria o una colonna univoca. Se non esiste, viene generata un'eccezione InvalidOperationException e i comandi non vengono generati.

L'oggetto DbCommandBuilder usa anche le Connectionproprietà , CommandTimeoute Transaction a cui fa riferimento l'oggetto SelectCommand. L'utente deve chiamare RefreshSchema se una di queste proprietà viene modificata o se viene sostituita.SelectCommand In caso contrario, le proprietà , UpdateCommande DeleteCommand mantengono i InsertCommandvalori precedenti.

Se si chiama Dispose, l'oggetto è non gestito dall'oggetto DbDataAdapterDbCommandBuilder e i comandi generati non vengono più usati.

Costruttori

DbCommandBuilder()

Inizializza una nuova istanza di una classe che eredita dalla classe DbCommandBuilder.

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.
CatalogSeparator	Ottiene o imposta una stringa usata come separatore di catalogo per un'istanza della classe DbCommandBuilder.
ConflictOption	Specifica quale enumerazione ConflictOption deve essere utilizzata dalla classe DbCommandBuilder.
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DataAdapter	Ottiene o imposta un oggetto DbDataAdapter per il quale sono generate automaticamente istruzioni Transact-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.
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.
SchemaSeparator	Ottiene o imposta il carattere da utilizzare come separatore tra l'identificatore di schema e altri identificatori.
SetAllValues	Specifica se in un'istruzione di aggiornamento sono inclusi tutti i valori delle colonne o soltanto quelli modificati.
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.
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)
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.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetDeleteCommand()	Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di eliminazione nell'origine dati.
GetDeleteCommand(Boolean)	Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di eliminazione nell'origine dati, eventualmente utilizzando le colonne per i nomi dei parametri.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetInsertCommand()	Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati.
GetInsertCommand(Boolean)	Ottiene l'oggetto DbCommand generato automaticamente, richiesto per eseguire le operazioni di inserimento nell'origine dati, eventualmente utilizzando le colonne per i nomi dei parametri.
GetLifetimeService()	Obsoleti. 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 di @p#. Da utilizzare quando si compila un generatore di comandi personalizzato.
GetParameterName(String)	Restituisce il nome completo del parametro, dato il suo nome parziale.
GetParameterPlaceholder(Int32)	Restituisce il segnaposto del parametro nell'istruzione SQL associata.
GetSchemaTable(DbCommand)	Restituisce la tabella dello schema della classe 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 DbCommand generato automaticamente richiesto per eseguire le operazioni di aggiornamento nell'origine dati.
GetUpdateCommand(Boolean)	Ottiene l'oggetto DbCommand 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.
InitializeLifetimeService()	Obsoleti. 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)	Specificato un identificatore senza virgolette nel caso di catalogo corretto, viene restituito il formato corretto tra virgolette di quell'identificatore, incluso l'escape corretto di tutte le virgolette incorporate nell'identificatore.
RefreshSchema()	Elimina i comandi associati all'oggetto DbCommandBuilder.
RowUpdatingHandler(RowUpdatingEventArgs)	Aggiunge un gestore eventi per l'evento RowUpdating.
SetRowUpdatingHandler(DbDataAdapter)	Registra l'oggetto DbCommandBuilder per gestire l'evento RowUpdating per un oggetto DbDataAdapter.
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)	Specificato un identificatore con virgolette, viene restituito il formato corretto senza virgolette di quell'identificatore, incluso il corretto utilizzo di caratteri non di escape per le virgolette incorporate 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
• Panoramica di ADO.NET