DataAdapter Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DataAdapter.cs

Rappresenta un gruppo di comandi SQL e una connessione di database usati per riempire la classe DataSet e aggiornare l'origine dati.

public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter

public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter

type DataAdapter = class
    inherit Component
    interface IDataAdapter

Public Class DataAdapter
Inherits Component
Implements IDataAdapter

Ereditarietà

Object

MarshalByRefObject

Component

DataAdapter

Derivato

System.Data.Common.DbDataAdapter

Implementazioni

IDataAdapter

Commenti

L'oggetto DataAdapter funge da ponte tra un oggetto e un'origine DataSet dati per il recupero e il salvataggio dei dati. Fornisce DataAdapter questo bridge mappando Fill, che modifica i dati nell'oggetto DataSet in modo che corrispondano ai dati nell'origine dati e Update, che modifica i dati nell'origine dati in modo che corrispondano ai dati nell'oggetto DataSet.

Se ci si connette a un database SQL Server, è possibile aumentare le prestazioni complessive usando l'insieme SqlDataAdapter ai relativi oggetti e SqlConnection associatiSqlCommand. Per le origini dati supportate da OLE DB, usare l'oggetto con i DataAdapter relativi oggetti e OleDbConnection associatiOleDbCommand. Per le origini dati supportate da ODBC, usare l'oggetto con i DataAdapter relativi oggetti e OdbcConnection associatiOdbcCommand. Per i database Oracle, usare l'oggetto con i DataAdapter relativi oggetti e OracleConnection associatiOracleCommand.

Quando viene creata un'istanza di DataAdapter , le proprietà di lettura/scrittura vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il DataAdapter costruttore.

Costruttori

DataAdapter()	Inizializza una nuova istanza della classe DataAdapter.
DataAdapter(DataAdapter)	Inizializza una nuova istanza della DataAdapter classe da un oggetto esistente dello stesso tipo.

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.
AcceptChangesDuringUpdate	Ottiene o imposta se il metodo AcceptChanges() viene chiamato durante un metodo Update(DataSet).
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.
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)
FillLoadOption	Ottiene o imposta l'oggetto LoadOption che determina il modo in cui l'adattatore riempie l'oggetto DataTable dall'oggetto DbDataReader.
MissingMappingAction	Determina l'operazione da eseguire quando per i dati in arrivo non è presente una tabella o una colonna corrispondente.
MissingSchemaAction	Determina l'operazione da eseguire quando per lo schema DataSet esistente non esistono dati in arrivo corrispondenti.
ReturnProviderSpecificTypes	Ottiene o imposta un valore che indica se il metodo Fill deve restituire valori specifici del provider o valori comuni conformi a CLS.
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 .

Metodi

CloneInternals()	Obsoleti. Crea una copia di questa istanza di 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)
CreateTableMappings()	Crea un nuovo oggetto DataTableMappingCollection.
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DataAdapter e, facoltativamente, le risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Fill(DataSet)	Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle dell'origine dati.
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.
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.
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.
FillSchema(DataSet, SchemaType)	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, IDataReader)	Aggiunge una classe DataTable alla classe DataSet specificata.
FillSchema(DataTable, SchemaType, IDataReader)	Aggiunge una classe DataTable alla classe DataSet specificata.
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.
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.
ResetFillLoadOption()	Reimposta la proprietà FillLoadOption allo stato predefinito e fa in modo che il metodo Fill(DataSet) rispetti la proprietà AcceptChangesDuringFill.
ShouldSerializeAcceptChangesDuringFill()	Determina se la proprietà AcceptChangesDuringFill deve essere mantenuta.
ShouldSerializeFillLoadOption()	Determina se la proprietà FillLoadOption deve essere mantenuta.
ShouldSerializeTableMappings()	Determina se sono presenti più oggetti DataTableMapping e se è necessario conservarli.
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(DataSet)	Chiama le corrispondenti istruzioni INSERT, UPDATE o DELETE per ciascuna riga inserita, aggiornata o eliminata nell'oggetto DataSet specificato da un oggetto DataTable denominato "Table."

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.

Implementazioni dell'interfaccia esplicita

IDataAdapter.TableMappings

Ottiene una raccolta che indica come viene eseguito il mapping di una tabella di origine a una tabella del set di dati.

Vedi anche

• Panoramica di ADO.NET