IDataAdapter Interfaccia

Definizione

Spazio dei nomi:
System.Data
Assembly:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Origine:
IDataAdapter.cs
Origine:
IDataAdapter.cs
Origine:
ExpressionNode.cs

Consente a un oggetto di implementare un Oggetto DataAdapter e rappresenta un set di metodi e proprietà correlate all'azione di mapping utilizzate per compilare e aggiornare un'origine DataSet dati e aggiornare un'origine dati.

IDbDataAdapter istanze sono destinate a origini dati che sono (o simili) a database relazionali con comandi testuali (ad esempio 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

Esempio

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

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 che eredita di implementare una classe DataAdapter, che rappresenta il bridge tra un'origine dati e un oggetto DataSet. Per altre informazioni sulle classi DataAdapter, vedere Popolamento di un dataset da un dataadapter.

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

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

Note per gli implementatori

Per promuovere la coerenza tra i provider di dati di .NET Framework, denominare la classe che eredita nel formato Prv DataAdapter in cui Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi specifico del provider di dati di .NET Framework. Ad esempio, Sql è il prefisso della SqlDataAdapter classe nello spazio dei System.Data.SqlClient 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à

Nome Descrizione
MissingMappingAction

Indica o specifica se le tabelle o le colonne di origine non mappate vengono passate con i relativi nomi di origine per essere filtrati o per generare un errore.
MissingSchemaAction

Indica o specifica se le tabelle di origine, le colonne e le relative relazioni mancanti vengono aggiunte allo schema del set di dati, ignorate o causano 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

Nome Descrizione
Fill(DataSet)

Aggiunge o aggiorna righe nell'oggetto DataSet in modo che corrispondano a quelle nell'origine dati usando il DataSet nome e crea un DataTable oggetto denominato "Table".
FillSchema(DataSet, SchemaType)

Aggiunge un DataTable oggetto denominato "Table" all'oggetto specificato DataSet e configura lo schema in modo che corrisponda a quello nell'origine dati in base all'oggetto specificato SchemaType.
GetFillParameters()

Ottiene i parametri impostati dall'utente durante l'esecuzione di un'istruzione SQL SELECT.
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".

Si applica a