OleDbCommandBuilder 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. Questa classe non può essere ereditata.
public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilderpublic ref class OleDbCommandBuilder sealed : System::ComponentModel::Componentpublic sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilderpublic sealed class OleDbCommandBuilder : System.ComponentModel.Componenttype OleDbCommandBuilder = class
inherit DbCommandBuildertype OleDbCommandBuilder = class
inherit ComponentPublic NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilderPublic NotInheritable Class OleDbCommandBuilder
Inherits Component- Ereditarietà
- Ereditarietà
Esempio
Nell'esempio seguente vengono usati , OleDbCommandinsieme OleDbDataAdapter a e OleDbConnectionper selezionare le righe da un'origine dati. Nell'esempio viene passato un oggetto inizializzato DataSet, una 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
OleDbDataAdapter 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 OleDbCommandBuilder oggetto per generare automaticamente istruzioni SQL per gli aggiornamenti a tabella singola se si imposta la SelectCommand proprietà di OleDbDataAdapter. Quindi, tutte le istruzioni SQL aggiuntive non impostate vengono generate da OleDbCommandBuilder.
L'oggetto OleDbCommandBuilder viene registrato come listener per RowUpdating gli eventi ogni volta che si imposta la DataAdapter proprietà . È possibile associare un OleDbDataAdapter solo oggetto o OleDbCommandBuilder l'uno all'altro contemporaneamente.
Per generare istruzioni INSERT, UPDATE o DELETE, OleDbCommandBuilder 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.
OleDbCommandBuilder Usa inoltre 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 l'oggetto SelectCommand stesso viene sostituito. In caso contrario, le proprietà , UpdateCommande DeleteCommand mantengono i InsertCommandvalori precedenti.
Se si chiama Dispose, l'oggetto OleDbCommandBuilder viene disassociato da OleDbDataAdaptere i comandi generati non vengono più usati.
Costruttori
| Nome | Descrizione |
|---|---|
| OleDbCommandBuilder() |
Inizializza una nuova istanza della classe OleDbCommandBuilder. |
| OleDbCommandBuilder(OleDbDataAdapter) |
Inizializza una nuova istanza della OleDbCommandBuilder classe con l'oggetto associato OleDbDataAdapter . |
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 . (Ereditato da DbCommandBuilder) |
| CatalogSeparator |
Ottiene o imposta una stringa utilizzata come separatore di catalogo per un'istanza della DbCommandBuilder classe . (Ereditato da DbCommandBuilder) |
| ConflictOption |
Specifica quale ConflictOption deve essere utilizzato dall'oggetto DbCommandBuilder. (Ereditato da DbCommandBuilder) |
| Container |
Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component) |
| DataAdapter |
Ottiene o imposta un OleDbDataAdapter oggetto per il quale vengono generate automaticamente istruzioni 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. |
| 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. (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 come 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. (Ereditato da DbCommandBuilder) |
| SchemaSeparator |
Ottiene o imposta il carattere da utilizzare per il separatore tra l'identificatore dello schema e qualsiasi altro identificatore. (Ereditato da DbCommandBuilder) |
| SetAllValues |
Specifica se tutti i valori di colonna in un'istruzione update sono inclusi o modificati solo quelli. (Ereditato da DbCommandBuilder) |
| 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. (Ereditato da DbCommandBuilder) |
| 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) |
| DeriveParameters(OleDbCommand) |
Recupera le informazioni sui parametri dalla stored procedure specificata in OleDbCommand e popola la Parameters raccolta dell'oggetto specificato OleDbCommand . |
| 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. (Ereditato da DbCommandBuilder) |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate da Component e, facoltativamente, rilascia le risorse gestite. (Ereditato da Component) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetDeleteCommand() |
Ottiene l'oggetto generato OleDbCommand automaticamente necessario per eseguire eliminazioni nell'origine dati. |
| GetDeleteCommand(Boolean) |
Ottiene l'oggetto generato OleDbCommand automaticamente necessario per eseguire eliminazioni nell'origine dati. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetInsertCommand() |
Ottiene l'oggetto generato OleDbCommand automaticamente necessario per eseguire inserimenti nell'origine dati. |
| GetInsertCommand(Boolean) |
Ottiene l'oggetto generato OleDbCommand automaticamente necessario per eseguire inserimenti nell'origine dati. |
| 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. (Ereditato da DbCommandBuilder) |
| GetParameterPlaceholder(Int32) |
Restituisce il segnaposto per il parametro nell'istruzione SQL associata. (Ereditato da DbCommandBuilder) |
| GetSchemaTable(DbCommand) |
Restituisce la tabella dello schema per l'oggetto DbCommandBuilder. (Ereditato da 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 OleDbCommand automaticamente necessario per eseguire gli aggiornamenti nell'origine dati. |
| GetUpdateCommand(Boolean) |
Ottiene l'oggetto generato OleDbCommand 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. (Ereditato da DbCommandBuilder) |
| 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, OleDbConnection) |
Dato un identificatore senza virgolette nel caso di catalogo corretto, restituisce il formato tra virgolette corretto di tale identificatore. Ciò include l'escape corretto delle virgolette incorporate nell'identificatore. |
| QuoteIdentifier(String) |
Dato un identificatore senza virgolette nel caso di catalogo corretto, restituisce il formato tra virgolette corretto di tale identificatore. Ciò include l'escape corretto delle virgolette incorporate nell'identificatore. |
| RefreshSchema() |
Cancella i comandi associati a questo OleDbCommandBuilderoggetto . |
| RefreshSchema() |
Cancella i comandi associati a questo DbCommandBuilderoggetto . (Ereditato da DbCommandBuilder) |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Aggiunge un gestore eventi per l'evento RowUpdating . (Ereditato da DbCommandBuilder) |
| SetRowUpdatingHandler(DbDataAdapter) |
Registra per DbCommandBuilder gestire l'evento RowUpdating per un oggetto DbDataAdapter. (Ereditato da DbCommandBuilder) |
| 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, OleDbConnection) |
Dato un identificatore tra virgolette, restituisce la forma non racchiusa tra virgolette corretta di tale identificatore. Ciò include l'annullamento corretto dell'escape di tutte le virgolette incorporate nell'identificatore. |
| UnquoteIdentifier(String) |
Dato un identificatore tra virgolette, restituisce la forma non racchiusa tra virgolette corretta di tale identificatore. Ciò include l'annullamento corretto dell'escape di tutte le virgolette incorporate nell'identificatore. |
Eventi
| Nome | Descrizione |
|---|---|
| Disposed |
Si verifica quando il componente viene eliminato da una chiamata al Dispose() metodo . (Ereditato da Component) |
