DbCommandBuilder Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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::Componentpublic abstract class DbCommandBuilder : System.ComponentModel.Componenttype DbCommandBuilder = class
inherit ComponentPublic MustInherit Class DbCommandBuilder
Inherits Component- Ereditarietà
- Derivato
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. |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare 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, 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 |
| 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) |
