IDbDataAdapter Interfaccia

Riferimento

Definizione

Spazio dei nomi:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un insieme di proprietà relative ai comandi che vengono usate per compilare l'oggetto DataSet e aggiornare un'origine dati e viene implementata dai provider di dati .NET con accesso ai database relazionali.

public interface class IDbDataAdapter : System::Data::IDataAdapter

public interface IDbDataAdapter : System.Data.IDataAdapter

type IDbDataAdapter = interface
    interface IDataAdapter

Public Interface IDbDataAdapter
Implements IDataAdapter

Derivato: System.Data.Common.DbDataAdapter

System.Data.Odbc.OdbcDataAdapter

System.Data.OleDb.OleDbDataAdapter

System.Data.OracleClient.OracleDataAdapter

System.Data.SqlClient.SqlDataAdapter

Implementazioni: IDataAdapter

Esempio

Nell'esempio seguente vengono usate le classi derivate, e SqlCommand, SqlConnection SqlDataAdapter per selezionare i record da un'origine dati. Viene quindi restituito il riempimento DataSet . A tale scopo, il metodo viene passato a una stringa di connessione inizializzata 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 IDbDataAdapter eredita dall'interfaccia e consente a un oggetto di creare un DataAdapter progettato per l'uso IDataAdapter con un database relazionale. L'interfaccia IDbDataAdapter e, facoltativamente, la classe di utilità, , DbDataAdapterconsentono 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. Per altre informazioni sull'implementazione di provider di dati .NET Framework, vedere Implementazione di un .NET Framework provider di dati.

Un'applicazione non crea direttamente un'istanza dell'interfaccia, ma crea un'istanza IDbDataAdapter di una classe che eredita IDbDataAdapter e DbDataAdapter.

Le classi che ereditano devono implementare IDbDataAdapter i membri ereditati e in genere definiscono altri membri per aggiungere funzionalità specifiche del provider. Ad esempio, l'interfaccia IDbDataAdapter definisce la SelectCommand proprietà e l'interfaccia DbDataAdapter definisce un Fill metodo che accetta come DataTable parametro. A sua volta, la OleDbDataAdapter classe eredita la SelectCommand proprietà e 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 .NET Framework provider di dati. Ad esempio, Sql è il prefisso della SqlDataAdapter classe nello System.Data.SqlClient spazio dei nomi.

Quando si eredita dall'interfaccia IDbDataAdapter , è 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 con l'istruzione SELECT specificata SQL.
PrvDataAdapter(string selectCommandText, string selectConnectionString)	Inizializza una nuova istanza della classe PrvDataAdapter con un'istruzione SELECT SQL e una stringa di connessione.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection)	Inizializza una nuova istanza della classe PrvDataAdapter con un'istruzione SELECT SQL e un oggetto PrvConnection.

Proprietà

DeleteCommand	Ottiene o imposta un'istruzione SQL per l'eliminazione di record dal set di dati.
InsertCommand	Ottiene o imposta un'istruzione SQL utilizzata per inserire nuovi record nell'origine dati.
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. (Ereditato da IDataAdapter)
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. (Ereditato da IDataAdapter)
SelectCommand	Ottiene o imposta un'istruzione SQL utilizzata per selezionare i record nell'origine dati.
TableMappings	Ottiene una raccolta che indica come viene eseguito il mapping di una tabella di origine a una tabella del set di dati. (Ereditato da IDataAdapter)
UpdateCommand	Ottiene o imposta un'istruzione SQL utilizzata per aggiornare i record nell'origine 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". (Ereditato da IDataAdapter)
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. (Ereditato da IDataAdapter)
GetFillParameters()	Ottiene i parametri impostati dall'utente durante l'esecuzione di un'istruzione SQL SELECT. (Ereditato da IDataAdapter)
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". (Ereditato da IDataAdapter)

Si applica a