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.
Supporta l'implementazione dell'interfaccia IDbDataAdapter. Gli eredi di DbDataAdapter implementano un set di funzioni per fornire una tipizzazione forte, ma ereditano la maggior parte delle funzionalità necessarie per implementare in modo completo 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 classe e implementa l'interfaccia DataAdapterIDbDataAdapter . Consente a una classe di implementare un 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 devono implementare DbDataAdapter i membri ereditati e in genere definiscono altri membri 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 ADO Recordset 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*Command *selectCommand*) | Inizializza una nuova istanza della classe *Prv*DataAdapter con l'istruzione SQL SELECT specificata. |
| *Prv*DataAdapter(string *selectCommandText*, stringa *selectConnectionString*) | Inizializza una nuova istanza della classe *Prv*DataAdapter con un'istruzione SQL SELECT e un 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 assegnare un nome alla classe 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
| DbDataAdapter() |
Inizializza una nuova istanza di una classe DataAdapter. |
| DbDataAdapter(DbDataAdapter) |
Inizializza una nuova istanza della |
Campi
| DefaultSourceTableName |
Nome predefinito utilizzato dall'oggetto DataAdapter per i mapping di tabella. |
Proprietà
| AcceptChangesDuringFill |
Ottiene o imposta un valore che indica se il metodo AcceptChanges() viene chiamato per una classe DataRow dopo che questa è stata aggiunta alla classe DataTable, durante un'operazione del metodo Fill. (Ereditato da DataAdapter) |
| AcceptChangesDuringUpdate |
Ottiene o imposta se il metodo AcceptChanges() viene chiamato durante un metodo 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 che contiene Component. (Ereditato da Component) |
| ContinueUpdateOnError |
Ottiene o imposta un valore che specifica se generare un'eccezione quando viene rilevato un errore durante l'aggiornamento di una 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 il Component si trova in modalità progettazione. (Ereditato da Component) |
| Events |
Ottiene l'elenco dei gestori eventi allegati a questo Component. (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 DataTable dall'oggetto DbDataReader. (Ereditato da DataAdapter) |
| InsertCommand |
Ottiene o imposta un comando utilizzato per inserire nuovi record nell'origine dati. |
| MissingMappingAction |
Determina l'operazione da eseguire quando per i dati in arrivo non è presente una tabella o una colonna corrispondente. (Ereditato da DataAdapter) |
| MissingSchemaAction |
Determina l'operazione da eseguire quando per lo schema DataSet esistente non esistono dati in arrivo corrispondenti. (Ereditato da DataAdapter) |
| ReturnProviderSpecificTypes |
Ottiene o imposta un valore che indica se il metodo |
| SelectCommand |
Ottiene o imposta un comando utilizzato per selezionare i record nell'origine dati. |
| Site |
Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component) |
| TableMappings |
Ottiene una raccolta che fornisce il mapping primario tra una tabella di origine e un DataTableoggetto . (Ereditato da DataAdapter) |
| UpdateBatchSize |
Ottiene o imposta un valore che attiva o disabilita il supporto dell'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
| AddToBatch(IDbCommand) |
Aggiunge un'interfaccia IDbCommand al batch corrente. |
| ClearBatch() |
Rimuove tutti gli oggetti IDbCommand dal batch. |
| CloneInternals() |
Obsoleti.
Obsoleti.
Obsoleti.
Obsoleti.
Crea una copia di questa istanza di DataAdapter. (Ereditato da DataAdapter) |
| 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) |
| 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 oggetto DataTableMappingCollection. (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, le risorse gestite. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExecuteBatch() |
Esegue il batch corrente. |
| Fill(DataSet) |
Aggiunge o aggiorna righe nell'oggetto DataSet. |
| Fill(DataSet, Int32, Int32, String) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante DataSet e i nomi di DataTable. |
| Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati utilizzando i nomi, la stringa di comando e le funzioni di comando dell'oggetto DataSet e della tabella di origine. |
| Fill(DataSet, String) |
Aggiunge o aggiorna righe in un oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante l'oggetto DataSet e i relativi nomi DataTable. |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati usando i nomi DataSet, DataTable e IDataReader. |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante DataSet e i nomi di DataTable. (Ereditato da DataAdapter) |
| Fill(DataTable) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante il nome di DataTable. |
| Fill(DataTable, IDataReader) |
Aggiunge o aggiorna righe in un oggetto DataTable affinché corrispondano a quelle dell'origine dati, usando i nomi DataTable e IDataReader specificati. |
| Fill(DataTable, IDataReader) |
Aggiunge o aggiorna righe nell'oggetto DataTable affinché corrispondano a quelle dell'origine dati, utilizzando il nome di DataTable e l'oggetto IDataReader specificato. (Ereditato da DataAdapter) |
| Fill(DataTable, IDbCommand, CommandBehavior) |
Aggiunge o aggiorna righe in un oggetto DataTable affinché corrispondano a quelle dell'origine dati, utilizzando gli oggetti DataTable, IDbCommand e CommandBehavior specificati. |
| Fill(DataTable[], IDataReader, Int32, Int32) |
Aggiunge o aggiorna righe in un intervallo specificato nell'insieme di oggetti DataTable affinché corrispondano a quelle nell'origine dati. (Ereditato da DataAdapter) |
| Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) |
Aggiunge o aggiorna righe in un intervallo specificato nell'oggetto DataSet affinché corrispondano a quelle nell'origine dati mediante DataSet e i nomi di DataTable. |
| Fill(Int32, Int32, DataTable[]) |
Aggiunge o aggiorna righe in uno o più DataTable oggetti per corrispondere a quelli nell'origine dati a partire dal record specificato e recuperando fino al numero massimo di record specificato. |
| FillSchema(DataSet, SchemaType) |
Aggiunge un oggetto DataTable denominato "Table" all'oggetto DataSet specificato e configura lo schema perché corrisponda a quello presente nell'origine dati basato sull'oggetto SchemaType specificato. |
| FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) |
Aggiunge un oggetto DataTable all'oggetto DataSet specificato e di configurare lo schema in modo che corrisponda a quello dell'origine dati basato sull'oggetto SchemaType specificato. |
| FillSchema(DataSet, SchemaType, String) |
Aggiunge un oggetto DataTable all'oggetto DataSet specificato e configura lo schema in modo che corrisponda a quello dell'origine dati in base a SchemaType e DataTable. |
| FillSchema(DataSet, SchemaType, String, IDataReader) |
Aggiunge una classe DataTable alla classe DataSet specificata. (Ereditato da DataAdapter) |
| FillSchema(DataTable, SchemaType) |
Configura lo schema dell'oggetto DataTable specificato in base all'oggetto SchemaType specificato. |
| FillSchema(DataTable, SchemaType, IDataReader) |
Aggiunge una classe DataTable alla classe DataSet specificata. (Ereditato da DataAdapter) |
| FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) |
Configura lo schema dell'oggetto DataTable specificato, una stringa di comando SchemaType e valori di CommandBehavior. |
| GetBatchedParameter(Int32, Int32) |
Restituisce un'interfaccia IDataParameter da uno dei comandi nel batch corrente. |
| GetBatchedRecordsAffected(Int32, Int32, Exception) |
Restituisce informazioni su un tentativo di aggiornamento singolo all’interno di un aggiornamento in batch di dimensioni maggiori. |
| 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.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
| 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) |
| HasTableMappings() |
Indica se è stata creata una classe DataTableMappingCollection. (Ereditato da DataAdapter) |
| InitializeBatching() |
Inizializza i batch per la classe 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 dell'oggetto Object corrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject) |
| OnFillError(FillErrorEventArgs) |
Genera l'evento FillError. |
| OnFillError(FillErrorEventArgs) |
Richiamato quando si verifica un errore durante l'utilizzo del metodo |
| OnRowUpdated(RowUpdatedEventArgs) |
Genera l'evento |
| OnRowUpdating(RowUpdatingEventArgs) |
Genera l'evento |
| ResetFillLoadOption() |
Reimposta la proprietà FillLoadOption allo stato predefinito e fa in modo che il metodo Fill(DataSet) rispetti la proprietà AcceptChangesDuringFill. (Ereditato da DataAdapter) |
| ShouldSerializeAcceptChangesDuringFill() |
Determina se la proprietà AcceptChangesDuringFill deve essere mantenuta. (Ereditato da DataAdapter) |
| ShouldSerializeFillLoadOption() |
Determina se la proprietà FillLoadOption deve essere mantenuta. (Ereditato da DataAdapter) |
| ShouldSerializeTableMappings() |
Determina se sono presenti più oggetti DataTableMapping e se è necessario conservarli. (Ereditato da DataAdapter) |
| TerminateBatching() |
Termina l'operazione in batch per la classe 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) |
| Update(DataRow[]) |
Aggiorna il valore nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nella matrice specificata nell'oggetto DataSet. |
| Update(DataRow[], DataTableMapping) |
Aggiorna i valore nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nella matrice specificata degli oggetti DataRow. |
| Update(DataSet) |
Aggiorna il valore nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nell'oggetto DataSet specificato. |
| Update(DataSet, String) |
Aggiorna i valori nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nell'oggetto DataSet con il nome DataTable specificato. |
| Update(DataTable) |
Aggiorna il valore nel database eseguendo le rispettive istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nell'oggetto DataTable specificato. |
Eventi
| Disposed |
Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (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
| ICloneable.Clone() |
Obsoleti.
Crea un nuovo oggetto che è 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. |
