Classe SqlDataAdapter

L'oggetto SqlDataAdapter funge da ponte tra un oggetto DataSet e SQL Server per il recupero e il salvataggio dei dati. L'oggetto SqlDataAdapter fornisce questo ponte tramite il mapping del metodo Fill, che modifica i dati nell'oggetto DataSet affinché corrispondano a quelli nell'origine dati, e del metodo Update, che modifica i dati nell'origine dati affinché corrispondano a quelli nell'oggetto DataSet, tramite le istruzioni Transact-SQL appropriate applicate all'origine dati.

Quando vengono inseriti dati in un oggetto DataSet mediante SqlDataAdapter, vengono create le tabelle e le colonne necessarie per i dati restituiti, se non già esistenti. Tuttavia, le informazioni sulla chiave primaria non sono incluse nello schema creato in modo implicito a meno che la proprietà MissingSchemaAction non sia impostata su AddWithKey. È possibile inoltre fare in modo che l'oggetto SqlDataAdapter crei lo schema dell'oggetto DataSet, comprese le informazioni di chiave primaria, prima di inserire i dati mediante il metodo FillSchema. Per ulteriori informazioni, vedere Aggiunta di vincoli esistenti a un DataSet.

SqlDataAdapter viene utilizzato insieme a SqlConnection e a SqlCommand per migliorare le prestazioni durante la connessione a un database SQL Server.

L'oggetto SqlDataAdapter contiene inoltre le proprietà SelectCommand, InsertCommand, DeleteCommand, UpdateCommand e TableMappings mediante le quali viene semplificato il caricamento e l'aggiornamento dei dati.

Quando viene creata un'istanza di SqlDataAdapter, le proprietà di lettura/scrittura vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il costruttore del metodo SqlDataAdapter.

Nell'esempio che segue sono utilizzati gli oggetti SqlCommand, SqlDataAdapter e SqlConnection per selezionare record da un database e per compilare un oggetto DataSet con le righe selezionate. Viene quindi restituito l'oggetto DataSet compilato. A tal fine, al metodo viene passato un oggetto DataSet inizializzato, una stringa di connessione e una stringa di query che rappresenta 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;
    }
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

.NET Compact Framework