DbDataAdapter 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.
Facilita l'implementazione dell'interfaccia IDbDataAdapter . Gli eredi di DbDataAdapter implementano un set di funzioni per fornire tipizzazione avanzata, ma ereditano la maggior parte delle funzionalità necessarie per implementare completamente un Oggetto DataAdapter.
public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneablepublic abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapterpublic abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneabletype DbDataAdapter = class
inherit DataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype DbDataAdapter = class
inherit DataAdapter
interface ICloneabletype DbDataAdapter = class
inherit DataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapterPublic MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable- Ereditarietà
- Derivato
- Implementazioni
Commenti
La DbDataAdapter classe eredita dalla DataAdapter classe e implementa l'interfaccia IDbDataAdapter . Consente a una classe di implementare un Oggetto DataAdapter progettato per l'uso con un database relazionale.
Un'applicazione non crea direttamente un'istanza della DbDataAdapter classe , ma crea un'istanza di una classe che eredita da essa.
Le classi che ereditano DbDataAdapter devono implementare i membri ereditati e in genere definiscono membri aggiuntivi per aggiungere funzionalità specifiche del provider. Ad esempio, la DbDataAdapter classe definisce la SelectCommand proprietà e la DbDataAdapter classe definisce otto overload del Fill metodo . A sua volta, la OleDbDataAdapter classe eredita il Fill metodo e definisce anche due overload aggiuntivi di Fill che accettano un oggetto Recordset ADO come parametro.
Note per gli implementatori
Quando si eredita dalla DbDataAdapter classe , è consigliabile implementare i costruttori seguenti:
| Elemento | Descrizione |
|---|---|
| *Prv*DataAdapter() | Inizializza una nuova istanza della classe *Prv*DataAdapter. |
| *Prv*DataAdapter(*Prv*Comando *selectCommand*) | Inizializza una nuova istanza della classe *Prv*DataAdapter con l'istruzione SQL SELECT specificata. |
| *Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) | Inizializza una nuova istanza della classe *Prv*DataAdapter con un'istruzione SQL SELECT e una stringa di connessione. |
| *Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) | Inizializza una nuova istanza della classe *Prv*DataAdapter con un'istruzione SQL SELECT e un oggetto *Prv*Connection. |
Per promuovere la coerenza tra i provider di dati .NET Framework, è necessario denominare la classe che eredita nel formato PrvDataAdapter, dove Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi specifico del provider di dati .NET Framework. Ad esempio, "Sql" è il prefisso della SqlDataAdapter classe nello spazio dei nomi System.Data.SqlClient .
Costruttori
| Nome | Descrizione |
|---|---|
| DbDataAdapter() |
Inizializza una nuova istanza di una classe DataAdapter . |
| DbDataAdapter(DbDataAdapter) |
Inizializza una nuova istanza della |
Campi
| Nome | Descrizione |
|---|---|
| DefaultSourceTableName |
Nome predefinito utilizzato dall'oggetto DataAdapter per i mapping delle tabelle. |
Proprietà
| Nome | Descrizione |
|---|---|
| AcceptChangesDuringFill |
Ottiene o imposta un valore che indica se AcceptChanges() viene chiamato su un DataRow oggetto dopo l'aggiunta DataTable a durante una delle operazioni Fill . (Ereditato da DataAdapter) |
| AcceptChangesDuringUpdate |
Ottiene o imposta un valore che indica se AcceptChanges() viene chiamato durante un oggetto Update(DataSet). (Ereditato da DataAdapter) |
| CanRaiseEvents |
Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component) |
| Container |
Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component) |
| ContinueUpdateOnError |
Ottiene o imposta un valore che specifica se generare un'eccezione quando si verifica un errore durante un aggiornamento di riga. (Ereditato da DataAdapter) |
| DeleteCommand |
Ottiene o imposta un comando per l'eliminazione di record dal set di dati. |
| 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) |
| FillCommandBehavior |
Ottiene o imposta il comportamento del comando utilizzato per riempire l'adattatore dati. |
| FillLoadOption |
Ottiene o imposta l'oggetto LoadOption che determina il modo in cui l'adattatore riempie l'oggetto DataTableDbDataReaderda . (Ereditato da DataAdapter) |
| InsertCommand |
Ottiene o imposta un comando utilizzato per inserire nuovi record nell'origine dati. |
| MissingMappingAction |
Determina l'azione da eseguire quando i dati in ingresso non hanno una tabella o una colonna corrispondente. (Ereditato da DataAdapter) |
| MissingSchemaAction |
Determina l'azione da eseguire quando lo schema esistente DataSet non corrisponde ai dati in ingresso. (Ereditato da DataAdapter) |
| ReturnProviderSpecificTypes |
Ottiene o imposta un valore che indica se il metodo deve restituire valori specifici del |
| SelectCommand |
Ottiene o imposta un comando utilizzato per selezionare i record nell'origine dati. |
| Site |
Ottiene o imposta l'oggetto ISite dell'oggetto Component. (Ereditato da Component) |
| TableMappings |
Ottiene una raccolta che fornisce il mapping primario tra una tabella di origine e un oggetto DataTable. (Ereditato da DataAdapter) |
| UpdateBatchSize |
Ottiene o imposta un valore che abilita o disabilita il supporto per l'elaborazione batch e specifica il numero di comandi che è possibile eseguire in un batch. |
| UpdateCommand |
Ottiene o imposta un comando utilizzato per aggiornare i record nell'origine dati. |
Metodi
| Nome | Descrizione |
|---|---|
| AddToBatch(IDbCommand) |
Aggiunge un oggetto IDbCommand al batch corrente. |
| ClearBatch() |
Rimuove tutti gli IDbCommand oggetti dal batch. |
| CloneInternals() |
Obsoleti.
Obsoleti.
Obsoleti.
Obsoleti.
Crea una copia di questa istanza di DataAdapter. (Ereditato da DataAdapter) |
| 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) |
| CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inizializza una nuova istanza della classe RowUpdatedEventArgs. |
| CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inizializza una nuova istanza della classe RowUpdatingEventArgs. |
| CreateTableMappings() |
Crea un nuovo DataTableMappingCollectionoggetto . (Ereditato da DataAdapter) |
| Dispose() |
Rilascia tutte le risorse usate da Component. (Ereditato da Component) |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate da DbDataAdapter e, facoltativamente, rilascia le risorse gestite. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExecuteBatch() |
Esegue il batch corrente. |
| Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi delle tabelle di origine e, la stringa di comando e il comportamento del comando. |
| Fill(DataSet, Int32, Int32, String) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e DataTable . |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSetnomi , DataTablee IDataReader . |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e DataTable . (Ereditato da DataAdapter) |
| Fill(DataSet, String) |
Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e DataTable . |
| Fill(DataSet) |
Aggiunge o aggiorna righe in DataSet. |
| Fill(DataTable, IDataReader) |
Aggiunge o aggiorna righe in un DataTable oggetto in modo che corrispondano a quelle nell'origine dati usando i nomi e IDataReader specificatiDataTable. |
| Fill(DataTable, IDataReader) |
Aggiunge o aggiorna righe nell'oggetto DataTable in modo che corrispondano a quelle nell'origine dati usando il DataTable nome e l'oggetto specificato IDataReader. (Ereditato da DataAdapter) |
| Fill(DataTable, IDbCommand, CommandBehavior) |
Aggiunge o aggiorna righe in un DataTable oggetto in modo che corrispondano a quelle nell'origine dati usando l'oggetto specificato DataTableIDbCommand e CommandBehavior. |
| Fill(DataTable) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando il DataTable nome. |
| Fill(DataTable[], IDataReader, Int32, Int32) |
Aggiunge o aggiorna righe in un intervallo specificato nell'insieme di DataTable oggetti in modo che corrispondano a quelli nell'origine dati. (Ereditato da DataAdapter) |
| Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando i DataSet nomi e DataTable . |
| Fill(Int32, Int32, DataTable[]) |
Aggiunge o aggiorna righe in uno o più DataTable oggetti in modo che corrispondano a quelli nell'origine dati a partire dal record specificato e recuperando fino al numero massimo di record specificato. |
| FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) |
Aggiunge un DataTable oggetto all'oggetto specificato DataSet e configura lo schema in modo che corrisponda a quello nell'origine dati in base all'oggetto specificato SchemaType. |
| FillSchema(DataSet, SchemaType, String, IDataReader) |
Aggiunge un DataTable oggetto all'oggetto specificato DataSet. (Ereditato da DataAdapter) |
| FillSchema(DataSet, SchemaType, String) |
Aggiunge un DataTable oggetto all'oggetto specificato DataSet e configura lo schema in modo che corrisponda a quello nell'origine dati in base all'oggetto specificato SchemaType e DataTable. |
| FillSchema(DataSet, SchemaType) |
Aggiunge un DataTable oggetto denominato "Table" all'oggetto specificato DataSet e configura lo schema in modo che corrisponda a quello nell'origine dati in base all'oggetto specificato SchemaType. |
| FillSchema(DataTable, SchemaType, IDataReader) |
Aggiunge un DataTable oggetto all'oggetto specificato DataSet. (Ereditato da DataAdapter) |
| FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) |
Configura lo schema dell'oggetto specificato in base alla stringa di comando e CommandBehavior ai valori specificati.DataTableSchemaType |
| FillSchema(DataTable, SchemaType) |
Configura lo schema dell'oggetto specificato DataTable in base all'oggetto specificato SchemaType. |
| GetBatchedParameter(Int32, Int32) |
Restituisce un oggetto IDataParameter da uno dei comandi nel batch corrente. |
| GetBatchedRecordsAffected(Int32, Int32, Exception) |
Restituisce informazioni su un singolo tentativo di aggiornamento all'interno di un aggiornamento in batch più grande. |
| GetFillParameters() |
Ottiene i parametri impostati dall'utente durante l'esecuzione di un'istruzione SQL SELECT. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| 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) |
| HasTableMappings() |
Indica se è stato creato un oggetto DataTableMappingCollection . (Ereditato da DataAdapter) |
| InitializeBatching() |
Inizializza l'invio in batch per .DbDataAdapter |
| 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) |
| OnFillError(FillErrorEventArgs) |
Genera l'evento FillError. |
| OnFillError(FillErrorEventArgs) |
Richiamato quando si verifica un errore durante un oggetto |
| OnRowUpdated(RowUpdatedEventArgs) |
Genera l'evento |
| OnRowUpdating(RowUpdatingEventArgs) |
Genera l'evento |
| ResetFillLoadOption() |
FillLoadOption Reimposta lo stato predefinito e causa l'onore Fill(DataSet)AcceptChangesDuringFilldi . (Ereditato da DataAdapter) |
| ShouldSerializeAcceptChangesDuringFill() |
Determina se la AcceptChangesDuringFill proprietà deve essere persistente. (Ereditato da DataAdapter) |
| ShouldSerializeFillLoadOption() |
Determina se la FillLoadOption proprietà deve essere persistente. (Ereditato da DataAdapter) |
| ShouldSerializeTableMappings() |
Determina se uno o più DataTableMapping oggetti esistono e devono essere salvati in modo permanente. (Ereditato da DataAdapter) |
| TerminateBatching() |
Termina l'invio in batch per l'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) |
| Update(DataRow[], DataTableMapping) |
Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nella matrice di DataRow oggetti specificata. |
| Update(DataRow[]) |
Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nella matrice specificata in DataSet. |
| Update(DataSet, String) |
Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata in DataSet con il nome specificato DataTable . |
| Update(DataSet) |
Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nell'oggetto specificato DataSet. |
| Update(DataTable) |
Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nell'oggetto specificato DataTable. |
Eventi
| Nome | Descrizione |
|---|---|
| Disposed |
Si verifica quando il componente viene eliminato da una chiamata al Dispose() metodo . (Ereditato da Component) |
| FillError |
Restituito quando si verifica un errore durante un'operazione di riempimento. |
| FillError |
Restituito quando si verifica un errore durante un'operazione di riempimento. (Ereditato da DataAdapter) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| ICloneable.Clone() |
Obsoleti.
Crea un nuovo oggetto che rappresenta una copia dell'istanza corrente. |
| IDataAdapter.TableMappings |
Ottiene una raccolta che indica come viene eseguito il mapping di una tabella di origine a una tabella del set di dati. (Ereditato da DataAdapter) |
| IDbDataAdapter.DeleteCommand |
Ottiene o imposta un'istruzione SQL per l'eliminazione di record dal set di dati. |
| IDbDataAdapter.InsertCommand |
Ottiene o imposta un'istruzione SQL utilizzata per inserire nuovi record nell'origine dati. |
| IDbDataAdapter.SelectCommand |
Ottiene o imposta un'istruzione SQL utilizzata per selezionare i record nell'origine dati. |
| IDbDataAdapter.UpdateCommand |
Ottiene o imposta un'istruzione SQL utilizzata per aggiornare i record nell'origine dati. |
