IDataAdapter IDataAdapter IDataAdapter IDataAdapter Interface

Definizione

Consente a un oggetto di implementare un oggetto DataAdapter e rappresenta un insieme di metodi e proprietà correlate ad azioni di mapping utilizzate per riempire e aggiornare DataSet e aggiornare un'origine dati.Allows an object to implement a DataAdapter, and represents a set of methods and mapping action-related properties that are used to fill and update a DataSet and update a data source.

Le istanze di IDbDataAdapter sono per le origini dati che sono o sembrano database relazionali con comandi testuali (come Transact-SQL), mentre le istanze di IDataAdapter possono usare qualsiasi tipo di origine dati.IDbDataAdapter instances are for data sources that are (or resemble) relational databases with textual commands (like Transact-SQL), while IDataAdapter instances could can use any type of data source.

public interface class IDataAdapter
public interface IDataAdapter
type IDataAdapter = interface
Public Interface IDataAdapter
Derivato

Esempi

L'esempio seguente usa le classi derivate SqlCommand, SqlDataAdapter, e SqlConnection, per selezionare record da un database.The following example uses the derived classes, SqlCommand, SqlDataAdapter, and SqlConnection, to select records from a database. Compilato DataSet viene quindi restituito.The filled DataSet is then returned. A tale scopo, il metodo viene passato un oggetto inizializzato DataSet, una stringa di connessione e una stringa di query che è un'istruzione Transact-SQL SELECT.To do this, the method is passed an initialized DataSet, a connection string, and a query string that is a Transact-SQL SELECT statement.

private static DataSet SelectRows(DataSet dataset,
    string connectionString,string queryString) 
{
    using (SqlConnection connection = 
        new SqlConnection(connectionString))
    {
        SqlDataAdapter adapter = new SqlDataAdapter();
        adapter.SelectCommand = new SqlCommand(
            queryString, connection);
        adapter.Fill(dataset);
        return dataset;
    }
}

Public Function SelectRows( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New SqlConnection(connectionString)
        Dim adapter As New SqlDataAdapter()
        adapter.SelectCommand = New SqlCommand( _
            queryString, connection)
        adapter.Fill(dataSet)
        Return dataSet
    End Using
End Function

Commenti

Il IDataAdapter interfaccia consente a una classe che eredita implementare una classe di DataAdapter, che rappresenta il ponte tra un'origine dati e un DataSet.The IDataAdapter interface allows an inheriting class to implement a DataAdapter class, which represents the bridge between a data source and a DataSet. Per altre informazioni sulle classi di DataAdapter, vedere popolamento di un set di dati da un oggetto DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter.

Un'applicazione non crea un'istanza di IDataAdapter interfaccia direttamente, ma implementa un'istanza di una classe che eredita IDataAdapter.An application does not create an instance of the IDataAdapter interface directly, but implements an instance of a class that inherits IDataAdapter.

Le classi che ereditano IDataAdapter deve implementare i membri ereditati e in genere definiscono membri aggiuntivi per aggiungere funzionalità specifiche del provider.Classes that inherit IDataAdapter must implement the inherited members, and they typically define additional members to add provider-specific functionality. Ad esempio, il IDataAdapter interfaccia definisce un Fill metodo che accetta un DataSet come parametro.For example, the IDataAdapter interface defines a Fill method that takes a DataSet as a parameter. A sua volta, il OleDbDataAdapter classe eredita le Fill (metodo) e definisce anche due altri overload del Fill metodo che accetta un oggetto Recordset ADO come parametro.In turn, the OleDbDataAdapter class inherits the Fill method and also defines two additional overloads of the Fill method that take an ADO Recordset object as a parameter.

Note per gli implementatori

Per promuovere la coerenza tra i provider di dati .NET Framework, assegnare un nome alla classe che eredita il form Prv DataAdapter dove Prv è il prefisso uniform assegnato a tutte le classi in uno specifico spazio dei nomi provider di dati .NET Framework.To promote consistency among .NET Framework data providers, name the inheriting class in the form Prv DataAdapter where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Ad esempio, Sql è il prefisso del SqlDataAdapter classe la System.Data.SqlClient dello spazio dei nomi.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Quando si eredita dal IDataAdapter interfaccia, è necessario implementare i costruttori seguenti:When you inherit from the IDataAdapter interface, you should implement the following constructors:

ElementoItem DescrizioneDescription
PrvDataAdapter()PrvDataAdapter() Inizializza una nuova istanza della classe PrvDataAdapter.Initializes a new instance of the PrvDataAdapter class.

PrvDataAdapter (PrvCommand selectCommand)PrvDataAdapter(PrvCommand selectCommand) Inizializza una nuova istanza della classe PrvDataAdapter usando l'istruzione SQL SELECT specificata.Initializes a new instance of the PrvDataAdapter class by using the specified SQL SELECT statement.

PrvDataAdapter(string selectCommandText, string selectConnectionString)PrvDataAdapter(string selectCommandText, string selectConnectionString) Inizializza una nuova istanza della classe PrvDataAdapter usando un'istruzione SQL SELECT e una stringa di connessione.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a connection string.

PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inizializza una nuova istanza della classe PrvDataAdapter usando un'istruzione SQL SELECT e un oggetto PrvConnection.Initializes a new instance of the PrvDataAdapter class by using an SQL SELECT statement and a PrvConnection object.

Proprietà

MissingMappingAction MissingMappingAction MissingMappingAction MissingMappingAction

Indica o specifica se colonne o tabelle di origine non mappate vengono passate con i rispettivi nomi di origine per l'applicazione di filtri o per la generazione di un errore.Indicates or specifies whether unmapped source tables or columns are passed with their source names in order to be filtered or to raise an error.

MissingSchemaAction MissingSchemaAction MissingSchemaAction MissingSchemaAction

Indica o specifica se le tabelle, le colonne e le rispettive relazioni di origine mancanti verranno aggiunte allo schema dataset, verranno ignorate o causeranno la generazione di un errore.Indicates or specifies whether missing source tables, columns, and their relationships are added to the dataset schema, ignored, or cause an error to be raised.

TableMappings TableMappings TableMappings 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.

Metodi

Fill(DataSet) Fill(DataSet) Fill(DataSet) Fill(DataSet)

Aggiunge o aggiorna righe nell'oggetto DataSet affinché corrispondano a quelle presenti nell'origine dati utilizzando il nome dell'oggetto DataSet e crea un oggetto DataTable denominato "Table".Adds or updates rows in the DataSet to match those in the data source using the DataSet name, and creates a DataTable named "Table".

FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType)

Aggiunge un oggetto DataTable denominato "Table" all'oggetto DataSet specificato e configura lo schema in modo che corrisponda a quello nell'origine dati in base all'oggetto SchemaType specificato.Adds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

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.

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

Si applica a