DbCommandBuilder Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

netstandard.dll, System.Data.Common.dll

Origine:

DBCommandBuilder.cs

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

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

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.

DbDataAdapter Non genera automaticamente le istruzioni SQL necessarie per riconciliare le modifiche apportate a un DataSet oggetto 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. Quindi, tutte le istruzioni SQL aggiuntive non impostate vengono generate da DbCommandBuilder.

L'oggetto DbCommandBuilder viene registrato come listener per RowUpdating gli eventi ogni volta che si imposta la DataAdapter proprietà . È possibile associare un DbDataAdapter solo oggetto o DbCommandBuilder l'uno all'altro contemporaneamente.

Per generare istruzioni INSERT, UPDATE o DELETE, DbCommandBuilder utilizza 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.

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

DbCommandBuilder Usa inoltre 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 l'oggetto SelectCommand stesso viene sostituito. In caso contrario, le proprietà , UpdateCommande DeleteCommand mantengono i InsertCommandvalori precedenti.

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

Costruttori

Nome	Descrizione
DbCommandBuilder()	Inizializza una nuova istanza di una classe che eredita dalla DbCommandBuilder classe .

Proprietà

Nome	Descrizione
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
CatalogLocation	Ottiene o imposta l'oggetto per un'istanza CatalogLocation della DbCommandBuilder classe .
CatalogSeparator	Ottiene o imposta una stringa utilizzata come separatore di catalogo per un'istanza della DbCommandBuilder classe .
ConflictOption	Specifica quale ConflictOption deve essere utilizzato dall'oggetto DbCommandBuilder.
Container	Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component)
DataAdapter	Ottiene o imposta un DbDataAdapter oggetto per il quale vengono generate automaticamente istruzioni Transact-SQL.
DesignMode	Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (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, ad esempio 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 come spazi o token riservati.
SchemaSeparator	Ottiene o imposta il carattere da utilizzare per il separatore tra l'identificatore dello schema e qualsiasi altro identificatore.
SetAllValues	Specifica se tutti i valori di colonna in un'istruzione update sono inclusi o modificati solo quelli.
Site	Ottiene o imposta l'oggetto ISite dell'oggetto Component. (Ereditato da Component)

Metodi

Nome	Descrizione
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Consente all'implementazione del provider della DbCommandBuilder classe di gestire proprietà aggiuntive dei parametri.
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DbCommandBuilder e, facoltativamente, rilascia le risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetDeleteCommand()	Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire eliminazioni nell'origine dati.
GetDeleteCommand(Boolean)	Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire eliminazioni nell'origine dati, facoltativamente utilizzando colonne per i nomi dei parametri.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetInsertCommand()	Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire inserimenti nell'origine dati.
GetInsertCommand(Boolean)	Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire inserimenti nell'origine dati, facoltativamente utilizzando colonne per i nomi dei parametri.
GetLifetimeService()	Obsoleti. Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetParameterName(Int32)	Restituisce il nome del parametro specificato nel formato di @p#. Usare quando si compila un generatore di comandi personalizzato.
GetParameterName(String)	Restituisce il nome completo del parametro, in base al nome del parametro parziale.
GetParameterPlaceholder(Int32)	Restituisce il segnaposto per il parametro nell'istruzione SQL associata.
GetSchemaTable(DbCommand)	Restituisce la tabella dello schema per l'oggetto DbCommandBuilder.
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetUpdateCommand()	Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire gli aggiornamenti nell'origine dati.
GetUpdateCommand(Boolean)	Ottiene l'oggetto generato DbCommand automaticamente necessario per eseguire gli aggiornamenti nell'origine dati, facoltativamente utilizzando le colonne per i nomi dei parametri.
InitializeCommand(DbCommand)	Reimposta le CommandTimeoutproprietà , TransactionCommandType, e UpdateRowSource in 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 del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject)
QuoteIdentifier(String)	Dato un identificatore senza virgolette nel caso di catalogo corretto, restituisce la forma tra virgolette corretta di tale identificatore, inclusa l'escape corretta di eventuali virgolette incorporate nell'identificatore.
RefreshSchema()	Cancella i comandi associati a questo DbCommandBuilderoggetto .
RowUpdatingHandler(RowUpdatingEventArgs)	Aggiunge un gestore eventi per l'evento RowUpdating .
SetRowUpdatingHandler(DbDataAdapter)	Registra per DbCommandBuilder gestire l'evento RowUpdating per un oggetto DbDataAdapter.
ToString()	Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)
UnquoteIdentifier(String)	Dato un identificatore tra virgolette, restituisce il formato non racchiuso tra virgolette corretto di tale identificatore, incluso l'annullamento corretto dell'escape di eventuali virgolette incorporate nell'identificatore.

Eventi

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

Vedi anche

• Generazione di comandi con CommandBuilders
• Panoramica di ADO.NET