IDbDataAdapter IDbDataAdapter IDbDataAdapter IDbDataAdapter Interface

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

Esempi

L'esempio seguente usa le classi derivate SqlCommand, SqlDataAdapter e SqlConnection, per selezionare record da un'origine dati.The following example uses the derived classes, SqlCommand, SqlDataAdapter and SqlConnection, to select records from a data source. Compilato DataSet viene quindi restituito.The filled DataSet is then returned. A tale scopo, il metodo viene passato un oggetto inizializzato DataSet, 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

Il IDbDataAdapter interfaccia eredita dal IDataAdapter l'interfaccia e consente a un oggetto creare un oggetto DataAdapter progettato per l'uso 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. Il IDbDataAdapter interfaccia e, facoltativamente, la classe di utilità DbDataAdapter, consentono a una classe che eredita implementare una classe di DataAdapter, che rappresenta il ponte 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 altre informazioni sulle classi di DataAdapter, vedere popolamento di un set di dati da un oggetto DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter. Per altre informazioni sull'implementazione del provider di dati .NET Framework, vedere implementazione di un Provider di dati .NET Framework.For more information about implementing .NET Framework data providers, see Implementing a .NET Framework Data Provider.

Un'applicazione non crea un'istanza di IDbDataAdapter interfaccia direttamente, 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 deve implementare i membri ereditati e in genere definisce 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, il IDbDataAdapter interfaccia definisce i SelectCommand proprietà e il DbDataAdapter interfaccia definisce un Fill metodo 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, il OleDbDataAdapter classe eredita le SelectCommand proprietà e il Fill metodo e definisce anche due altri overload del Fill metodo che accetta 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 i provider di dati .NET Framework, assegnare un nome alla classe che eredita il form Prv DataAdapter dove Prv è il prefisso uniform assegnato a tutte le classi in uno specifico spazio dei nomi provider di dati .NET Framework.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 del SqlDataAdapter classe la System.Data.SqlClient dello spazio dei nomi.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Quando si eredita dal IDbDataAdapter interfaccia, è 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 (PrvCommand selectCommand)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 con un'istruzione SQL SELECT e un oggetto PrvConnection PrvDataAdapter.Initializes a new instance of the PrvDataAdapter class with an SQL SELECT statement and a PrvConnection object.

Proprietà

DeleteCommand DeleteCommand DeleteCommand 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 InsertCommand InsertCommand 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 MissingMappingAction MissingMappingAction 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.

(Inherited from IDataAdapter)
MissingSchemaAction MissingSchemaAction MissingSchemaAction 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.

(Inherited from IDataAdapter)
SelectCommand SelectCommand SelectCommand 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 TableMappings TableMappings 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.

(Inherited from IDataAdapter)
UpdateCommand UpdateCommand UpdateCommand 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) Fill(DataSet) Fill(DataSet) 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".

(Inherited from IDataAdapter)
FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) 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.

(Inherited from IDataAdapter)
GetFillParameters() GetFillParameters() GetFillParameters() 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.

(Inherited from IDataAdapter)
Update(DataSet) Update(DataSet) Update(DataSet) 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".

(Inherited from IDataAdapter)

Si applica a