IDbDataAdapter Interfaccia

Definizione

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
Implementazioni

Esempio

Nell'esempio seguente vengono usate le classi derivate, e SqlCommandSqlConnection, 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 provider di dati .NET Framework.

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 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 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 SQL SELECT specificata.
PrvDataAdapter(string selectCommandText, string selectConnectionString) Inizializza una nuova istanza della classe PrvDataAdapter con un'istruzione SQL SELECT e una stringa di connessione.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inizializza una nuova istanza della classe PrvDataAdapter con un'istruzione SQL SELECT 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 perché corrisponda a quello presente nell'origine dati basato sull'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