IDbDataAdapter Interfaccia

Definizione

Rappresenta un insieme di proprietà relative ai comandi che vengono utilizzate per compilare l'oggetto DataSet e aggiornare un'origine dati e viene implementata dai provider di dati .NET Framework con accesso ai database relazionali.Represents a set of command-related properties that are used to fill the DataSet and update a data source, and is implemented by .NET Framework data providers that access relational databases.

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 utilizzate le classi derivate, SqlCommand, SqlDataAdapter e SqlConnection, per selezionare i record da un'origine dati.The following example uses the derived classes, SqlCommand, SqlDataAdapter and SqlConnection, to select records from a data source. Viene quindi restituita la DataSet compilata.The filled DataSet is then returned. A tale scopo, al metodo viene passato un DataSetinizializzato, una stringa di connessione e una stringa di query che è un'istruzione Transact-SQL SELECT.To accomplish this, the method is passed an initialized DataSet, a connection string, and a query string that is a Transact-SQL SELECT statement.

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 IDataAdapter e consente a un oggetto di creare un DataAdapter progettato per l'utilizzo con un database relazionale.The IDbDataAdapter interface inherits from the IDataAdapter interface and allows an object to create a DataAdapter designed for use with a relational database. L'interfaccia IDbDataAdapter e, facoltativamente, la classe di utilità, DbDataAdapter, consentono a una classe che eredita di implementare una classe DataAdapter, che rappresenta il Bridge tra un'origine dati e un DataSet.The IDbDataAdapter interface and, optionally, the utility class, DbDataAdapter, allow an inheriting class to implement a DataAdapter class, which represents the bridge between a data source and a DataSet. Per ulteriori informazioni sulle classi DataAdapter, vedere popolamento di un DataSet da un oggetto DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter. Per ulteriori informazioni sull'implementazione di .NET Framework provider di dati, vedere implementazione di un .NET Framework provider di dati.For more information about implementing .NET Framework data providers, see Implementing a .NET Framework Data Provider.

Un'applicazione non crea direttamente un'istanza dell'interfaccia IDbDataAdapter, ma crea un'istanza di una classe che eredita IDbDataAdapter e DbDataAdapter.An application does not create an instance of the IDbDataAdapter interface directly, but creates an instance of a class that inherits IDbDataAdapter and DbDataAdapter.

Le classi che ereditano IDbDataAdapter devono implementare i membri ereditati e in genere definiscono membri aggiuntivi per aggiungere funzionalità specifiche del provider.Classes that inherit IDbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. Ad esempio, l'interfaccia IDbDataAdapter definisce la proprietà SelectCommand e l'interfaccia DbDataAdapter definisce un metodo Fill che accetta un DataTable come parametro.For example, the IDbDataAdapter interface defines the SelectCommand property, and the DbDataAdapter interface defines a Fill method that takes a DataTable as a parameter. A sua volta, la classe OleDbDataAdapter eredita la proprietà SelectCommand e il metodo Fill e definisce anche due overload aggiuntivi del metodo Fill che accettano un oggetto recordset ADO come parametro.In turn, the OleDbDataAdapter class inherits the SelectCommand property and the Fill method, and also defines two additional overloads of the Fill method that take an ADO Recordset object as a parameter.

Note per gli implementatori

Per promuovere la coerenza tra .NET Framework provider di dati, denominare la classe che eredita nel formato Prv DataAdapter, dove Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi del provider di dati .NET Framework specifico.To promote consistency among .NET Framework data providers, name the inheriting class in the form Prv DataAdapter where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Ad esempio, Sql è il prefisso della classe SqlDataAdapter nello spazio dei nomi System.Data.SqlClient.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Quando si eredita dall'interfaccia IDbDataAdapter, è necessario implementare i costruttori seguenti:When you inherit from the IDbDataAdapter interface, you should implement the following constructors:

ElementoItem DescrizioneDescription
PrvDataAdapter()PrvDataAdapter() Inizializza una nuova istanza della classe PrvDataAdapter.Initializes a new instance of the PrvDataAdapter class.
PrvDataAdapter (selectCommand PrvCommand)PrvDataAdapter(PrvCommand selectCommand) Inizializza una nuova istanza della classe PrvDataAdapter con l'istruzione SQL SELECT specificata.Initializes a new instance of the PrvDataAdapter class with the specified SQL SELECT statement.
PrvDataAdapter(string selectCommandText, string selectConnectionString)PrvDataAdapter(string selectCommandText, string selectConnectionString) Inizializza una nuova istanza della classe PrvDataAdapter con un'istruzione SQL SELECT e una stringa di connessione.Initializes a new instance of the PrvDataAdapter class with an SQL SELECT statement and a connection string.
PrvDataAdapter (String selectCommandText, PrvConnection selectConnection)PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inizializza una nuova istanza della classe PrvDataAdapter con un'istruzione SQL SELECT e un oggetto PrvConnection.Initializes a new instance of the PrvDataAdapter class with an SQL SELECT statement and a PrvConnection object.

Proprietà

DeleteCommand

Ottiene o imposta un'istruzione SQL per l'eliminazione di record dal set di dati.Gets or sets an SQL statement for deleting records from the data set.

InsertCommand

Ottiene o imposta un'istruzione SQL utilizzata per inserire nuovi record nell'origine dati.Gets or sets an SQL statement used to insert new records into the data source.

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.Indicates or specifies whether unmapped source tables or columns are passed with their source names in order to be filtered or to raise an error.

(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.Indicates or specifies whether missing source tables, columns, and their relationships are added to the dataset schema, ignored, or cause an error to be raised.

(Ereditato da IDataAdapter)
SelectCommand

Ottiene o imposta un'istruzione SQL utilizzata per selezionare i record nell'origine dati.Gets or sets an SQL statement used to select records in the data source.

TableMappings

Indica come viene eseguito il mapping tra una tabella di origine e una tabella dataset.Indicates how a source table is mapped to a dataset table.

(Ereditato da IDataAdapter)
UpdateCommand

Ottiene o imposta un'istruzione SQL utilizzata per aggiornare i record nell'origine dati.Gets or sets an SQL statement used to update records in the data source.

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".Adds or updates rows in the DataSet to match those in the data source using the DataSet name, and creates a DataTable named "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.Adds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

(Ereditato da IDataAdapter)
GetFillParameters()

Ottiene i parametri impostati dall'utente durante l'esecuzione di un'istruzione SQL SELECT.Gets the parameters set by the user when executing an SQL SELECT statement.

(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".Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table".

(Ereditato da IDataAdapter)

Si applica a