DataAdapter Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.dll

Rappresenta un set di comandi SQL e una connessione di database utilizzata per riempire e aggiornare l'origine DataSet 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

funge DataAdapter da ponte tra un DataSet oggetto e un'origine dati per il recupero e il salvataggio dei dati. Fornisce DataAdapter questo bridge eseguendo il mapping Fill, che modifica i dati in DataSet 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 di SQL Server, è possibile migliorare le prestazioni complessive usando gli oggetti SqlDataAdapter insieme agli oggetti /SqlCommand e SqlConnection associati. Per le origini dati supportate da OLE DB, utilizzare con gli DataAdapter oggetti e OleDbConnection associatiOleDbCommand. Per le origini dati supportate da ODBC, utilizzare con gli DataAdapter oggetti e OdbcConnection associatiOdbcCommand. Per i database Oracle, usare con gli DataAdapter oggetti e OracleConnection associatiOracleCommand.

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

Costruttori

Nome	Descrizione
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à

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 .
AcceptChangesDuringUpdate	Ottiene o imposta un valore che indica se AcceptChanges() viene chiamato durante un oggetto Update(DataSet).
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.
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)
FillLoadOption	Ottiene o imposta l'oggetto LoadOption che determina il modo in cui l'adattatore riempie l'oggetto DataTableDbDataReaderda .
MissingMappingAction	Determina l'azione da eseguire quando i dati in ingresso non hanno una tabella o una colonna corrispondente.
MissingSchemaAction	Determina l'azione da eseguire quando lo schema esistente DataSet non corrisponde ai dati in ingresso.
ReturnProviderSpecificTypes	Ottiene o imposta un valore che indica se il metodo deve restituire valori specifici del Fill provider o valori comuni conformi a CLS.
Site	Ottiene o imposta il ISite del Component. (Ereditato da Component)
TableMappings	Ottiene una raccolta che fornisce il mapping primario tra una tabella di origine e un oggetto DataTable.

Metodi

Nome	Descrizione
CloneInternals()	Obsoleti. Crea una copia di questa istanza di 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)
CreateTableMappings()	Crea un nuovo DataTableMappingCollectionoggetto .
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DataAdapter e, facoltativamente, rilascia le risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
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 .
Fill(DataSet)	Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati.
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.
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.
FillSchema(DataSet, SchemaType, String, IDataReader)	Aggiunge un DataTable oggetto all'oggetto specificato DataSet.
FillSchema(DataSet, SchemaType)	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(DataTable, SchemaType, IDataReader)	Aggiunge un DataTable oggetto all'oggetto specificato DataSet.
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()	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 .
InitializeLifetimeService()	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)	Richiamato quando si verifica un errore durante un oggetto Fill.
ResetFillLoadOption()	FillLoadOption Reimposta lo stato predefinito e causa l'onore Fill(DataSet)AcceptChangesDuringFilldi .
ShouldSerializeAcceptChangesDuringFill()	Determina se la AcceptChangesDuringFill proprietà deve essere persistente.
ShouldSerializeFillLoadOption()	Determina se la FillLoadOption proprietà deve essere persistente.
ShouldSerializeTableMappings()	Determina se uno o più DataTableMapping oggetti esistono e devono essere salvati in modo permanente.
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(DataSet)	Chiama le rispettive istruzioni INSERT, UPDATE o DELETE per ogni riga inserita, aggiornata o eliminata nell'oggetto specificato DataSet da un DataTable oggetto denominato "Table".

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.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
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