DataAdapter DataAdapter DataAdapter DataAdapter Class

Definizione

Rappresenta un gruppo di comandi SQL e una connessione a un database utilizzati per riempire la classe DataSet e aggiornare l'origine dati.Represents a set of SQL commands and a database connection that are used to fill the DataSet and update the data source.

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à
Derivato
Implementazioni

Commenti

Il DataAdapter funge da ponte tra un' DataSet e un'origine dati per il recupero e salvataggio dei dati.The DataAdapter serves as a bridge between a DataSet and a data source for retrieving and saving data. Il DataAdapter fornisce questo bridge eseguendo il mapping Fill, che modifica i dati nel DataSet associare i dati nell'origine dati, e Update, che modifica i dati nell'origine dei dati in modo che corrispondano quelli nel DataSet.The DataAdapter provides this bridge by mapping Fill, which changes the data in the DataSet to match the data in the data source, and Update, which changes the data in the data source to match the data in the DataSet.

Se ci si connette a un database di SQL Server, è possibile aumentare le prestazioni complessive usando il SqlDataAdapter insieme a esso associata SqlCommand e SqlConnection oggetti.If you are connecting to a SQL Server database, you can increase overall performance by using the SqlDataAdapter along with its associated SqlCommand and SqlConnection objects. Per le origini dati OLE DB supportati, usare il DataAdapter con l'identificatore associato OleDbCommand e OleDbConnection oggetti.For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. Per le origini dati supportate da ODBC, usare il DataAdapter con l'identificatore associato OdbcCommand e OdbcConnection oggetti.For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. Per i database Oracle, usare il DataAdapter con l'identificatore associato OracleCommand e OracleConnection oggetti.For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.

Quando un'istanza di DataAdapter viene creata, la lettura/scrittura proprietà vengono impostate sui valori iniziali.When an instance of DataAdapter is created, the read/write properties are set to initial values. Per un elenco di questi valori, vedere il DataAdapter costruttore.For a list of these values, see the DataAdapter constructor.

Costruttori

DataAdapter() DataAdapter() DataAdapter() DataAdapter()

Inizializza una nuova istanza di una classe DataAdapter.Initializes a new instance of a DataAdapter class.

DataAdapter(DataAdapter) DataAdapter(DataAdapter) DataAdapter(DataAdapter) DataAdapter(DataAdapter)

Inizializza una nuova istanza di una classe DataAdapter da un oggetto esistente dello stesso tipo.Initializes a new instance of a DataAdapter class from an existing object of the same type.

Proprietà

AcceptChangesDuringFill AcceptChangesDuringFill AcceptChangesDuringFill 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.Gets or sets a value indicating whether AcceptChanges() is called on a DataRow after it is added to the DataTable during any of the Fill operations.

AcceptChangesDuringUpdate AcceptChangesDuringUpdate AcceptChangesDuringUpdate AcceptChangesDuringUpdate

Ottiene o imposta se il metodo AcceptChanges() viene chiamato durante un metodo Update(DataSet).Gets or sets whether AcceptChanges() is called during a Update(DataSet).

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Inherited from Component)
ContinueUpdateOnError ContinueUpdateOnError ContinueUpdateOnError ContinueUpdateOnError

Ottiene o imposta un valore che specifica se generare un'eccezione quando viene rilevato un errore durante l'aggiornamento di una riga.Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
FillLoadOption FillLoadOption FillLoadOption FillLoadOption

Ottiene o imposta l'oggetto LoadOption che determina il modo in cui l'adattatore riempie l'oggetto DataTable dall'oggetto DbDataReader.Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

MissingMappingAction MissingMappingAction MissingMappingAction MissingMappingAction

Determina l'operazione da eseguire quando per i dati in arrivo non è presente una tabella o una colonna corrispondente.Determines the action to take when incoming data does not have a matching table or column.

MissingSchemaAction MissingSchemaAction MissingSchemaAction MissingSchemaAction

Determina l'operazione da eseguire quando per lo schema DataSet esistente non esistono dati in arrivo corrispondenti.Determines the action to take when existing DataSet schema does not match incoming data.

ReturnProviderSpecificTypes ReturnProviderSpecificTypes ReturnProviderSpecificTypes ReturnProviderSpecificTypes

Ottiene o imposta un valore che indica se il metodo Fill deve restituire valori specifici del provider o valori comuni conformi a CLS.Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

Site Site Site Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Inherited from Component)
TableMappings TableMappings TableMappings TableMappings

Ottiene un insieme che contiene il mapping principale tra una tabella di origine e un oggetto DataTable.Gets a collection that provides the master mapping between a source table and a DataTable.

Metodi

CloneInternals() CloneInternals() CloneInternals() CloneInternals()

Crea una copia di questa istanza di DataAdapter.Creates a copy of this instance of DataAdapter.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateTableMappings() CreateTableMappings() CreateTableMappings() CreateTableMappings()

Crea un nuovo oggetto DataTableMappingCollection.Creates a new DataTableMappingCollection.

Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da DataAdapter e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the DataAdapter and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Fill(DataSet) Fill(DataSet) Fill(DataSet) Fill(DataSet)

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle dell'origine dati.Adds or refreshes rows in the DataSet to match those in the data source.

Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32) 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.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) 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.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) 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.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) 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.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader)

Aggiunge una classe DataTable alla classe DataSet specificata.Adds a DataTable to the specified DataSet.

FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader)

Aggiunge una classe DataTable alla classe DataSet specificata.Adds a DataTable to the specified DataSet.

GetFillParameters() GetFillParameters() GetFillParameters() GetFillParameters()

Ottiene i parametri impostati dall'utente durante l'esecuzione di un'istruzione SQL SELECT.Gets the parameters set by the user when executing an SQL SELECT statement.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
HasTableMappings() HasTableMappings() HasTableMappings() HasTableMappings()

Indica se è stata creata una classe DataTableMappingCollection.Indicates whether a DataTableMappingCollection has been created.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs)

Richiamato quando si verifica un errore durante l'utilizzo del metodo Fill.Invoked when an error occurs during a Fill.

ResetFillLoadOption() ResetFillLoadOption() ResetFillLoadOption() ResetFillLoadOption()

Reimposta la proprietà FillLoadOption allo stato predefinito e fa in modo che il metodo Fill(DataSet) rispetti la proprietà AcceptChangesDuringFill.Resets FillLoadOption to its default state and causes Fill(DataSet) to honor AcceptChangesDuringFill.

ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill()

Determina se la proprietà AcceptChangesDuringFill deve essere mantenuta.Determines whether the AcceptChangesDuringFill property should be persisted.

ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption()

Determina se la proprietà FillLoadOption deve essere mantenuta.Determines whether the FillLoadOption property should be persisted.

ShouldSerializeTableMappings() ShouldSerializeTableMappings() ShouldSerializeTableMappings() ShouldSerializeTableMappings()

Determina se sono presenti più oggetti DataTableMapping e se è necessario conservarli.Determines whether one or more DataTableMapping objects exist and they should be persisted.

ToString() ToString() ToString() ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Inherited from Component)
Update(DataSet) Update(DataSet) Update(DataSet) 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."Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table."

Eventi

Disposed Disposed Disposed Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
FillError FillError FillError FillError

Restituito quando si verifica un errore durante un'operazione di riempimento.Returned when an error occurs during a fill operation.

Implementazioni dell'interfaccia esplicita

IDataAdapter.TableMappings IDataAdapter.TableMappings IDataAdapter.TableMappings IDataAdapter.TableMappings

Indica come viene eseguito il mapping tra una tabella di origine e una tabella dataset.Indicates how a source table is mapped to a dataset table.

Si applica a

Vedi anche