DataAdapter Classe

Definizione

Rappresenta un gruppo di comandi SQL e una connessione di database usati 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 ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapter
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
public abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
type DataAdapter = class
    inherit Component
    interface IDataAdapter
Public Class DataAdapter
Inherits Component
Implements IDataAdapter
Public MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapter
Ereditarietà
Derivato
Implementazioni

Commenti

Il DataAdapter funge da ponte tra una DataSet e un'origine dati per il recupero e il 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 del 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 nella 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 agli oggetti SqlCommand e SqlConnection associati.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 supportate da OLE DB, usare il DataAdapter con gli oggetti OleDbCommand e OleDbConnection associati.For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. Per le origini dati supportate da ODBC, utilizzare la DataAdapter con gli oggetti OdbcCommand e OdbcConnection associati.For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. Per i database Oracle, utilizzare la DataAdapter con gli oggetti OracleCommand e OracleConnection associati.For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.

Quando viene creata un'istanza di DataAdapter, le proprietà di lettura/scrittura 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 costruttore DataAdapter.For a list of these values, see the DataAdapter constructor.

Costruttori

DataAdapter()

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

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

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

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

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

(Ereditato da Component)
Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the 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.Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

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.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this 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.Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

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

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

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

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

(Ereditato da Component)
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()

Crea una copia di questa istanza di DataAdapter.Creates a copy of this instance of 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
CreateTableMappings()

Crea un nuovo oggetto DataTableMappingCollection.Creates a new DataTableMappingCollection.

Dispose()

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

(Ereditato da Component)
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)

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

(Ereditato da Object)
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)

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)

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)

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)

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)

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

FillSchema(DataTable, SchemaType, IDataReader)

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

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()

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

(Ereditato da Object)
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.

(Ereditato da MarshalByRefObject)
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.

(Ereditato da Component)
GetType()

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

(Ereditato da Object)
HasTableMappings()

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

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.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

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

(Ereditato da Object)
MemberwiseClone(Boolean)

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

(Ereditato da MarshalByRefObject)
OnFillError(FillErrorEventArgs)

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

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()

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

ShouldSerializeFillLoadOption()

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

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()

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.

(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."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

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.

(Ereditato da Component)
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

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