DbDataAdapter Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbDataAdapter.cs

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::IDbDataAdapter

public abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapter

type DbDataAdapter = class
    inherit DataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapter

Ereditarietà

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

Derivato

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementazioni

IDataAdapter IDbDataAdapter ICloneable

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 DataAdapter classe da un oggetto esistente dello stesso tipo.

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 Fill deve restituire valori specifici del provider o valori comuni conformi a CLS. (Ereditato da DataAdapter)
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. 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 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 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)	Richiamato quando si verifica un errore durante l'utilizzo del metodo Fill. (Ereditato da DataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Genera l'evento RowUpdated di un provider di dati .NET.
OnRowUpdating(RowUpdatingEventArgs)	Genera l'evento RowUpdating di un provider di dati .NET.
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. (Ereditato da DataAdapter)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()	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.

Vedi anche

• Oggetti DbProviderFactory (ADO.NET)
• Panoramica di ADO.NET