IDataAdapter Interfaccia

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

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.

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.

public interface class IDataAdapter

public interface IDataAdapter

type IDataAdapter = interface

Public Interface IDataAdapter

Derivato

System.Data.Common.DataAdapter

System.Data.Common.DbDataAdapter

System.Data.IDbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Esempio

Nell'esempio seguente vengono usate le classi derivate, , SqlCommand, SqlDataAdaptere SqlConnection, per selezionare i record da un database. Viene quindi restituito il riempimento DataSet . A tale scopo, il metodo viene passato a un stringa di connessione inizializzato DataSete a una stringa di query che è un'istruzione Transact-SQL SELECT.

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

L'interfaccia IDataAdapter consente a una classe eredita di implementare una classe DataAdapter, che rappresenta il bridge tra un'origine dati e un DataSetoggetto . Per altre informazioni sulle classi DataAdapter, vedere Popolare un DataSet da un DataAdapter.

Un'applicazione non crea direttamente un'istanza dell'interfaccia, ma implementa IDataAdapterun'istanza IDataAdapter di una classe che eredita .

Le classi che ereditano devono implementare IDataAdapter i membri ereditati e in genere definiscono altri membri per aggiungere funzionalità specifiche del provider. Ad esempio, l'interfaccia IDataAdapter definisce un metodo che accetta DataSet come Fill parametro. A sua volta, la OleDbDataAdapter classe eredita il Fill metodo e definisce anche due overload aggiuntivi del Fill metodo che accettano un oggetto ADO Recordset come parametro.

Note per gli implementatori

Per promuovere la coerenza tra i provider di dati .NET Framework, assegnare un nome alla classe ereditata nel modulo Prv DataAdapter in cui Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi specifico del provider di dati .NET Framework. Ad esempio, Sql è il prefisso della SqlDataAdapter classe nello System.Data.SqlClient spazio dei nomi.

Quando si eredita dall'interfaccia IDataAdapter , è necessario implementare i costruttori seguenti:

Elemento	Descrizione
PrvDataAdapter()	Inizializza una nuova istanza della classe PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand)	Inizializza una nuova istanza della classe PrvDataAdapter usando l'istruzione SQL SELECT specificata.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Inizializza una nuova istanza della classe PrvDataAdapter usando un'istruzione SQL SELECT e un stringa di connessione.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Inizializza una nuova istanza della classe PrvDataAdapter usando un'istruzione SQL SELECT e un oggetto PrvConnection.

Proprietà

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.
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.
TableMappings	Ottiene una raccolta che indica come viene eseguito il mapping di una tabella di origine a una tabella del set di dati.

Metodi

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".
FillSchema(DataSet, SchemaType)	Aggiunge un oggetto DataTable denominato "Table" all'oggetto DataSet specificato e configura lo schema perché corrisponda a quello presente nell'origine dati basato sull'oggetto SchemaType specificato.
GetFillParameters()	Ottiene i parametri impostati dall'utente durante l'esecuzione di un'istruzione SQL SELECT.
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".