IDbDataAdapter Interface

Definição

Representa um conjunto de propriedades relacionadas ao comando que são usadas para preencher o DataSet e atualizar uma fonte de dados, o qual é implementado por provedores de dados .NET que acessam bancos de dados relacionais.Represents a set of command-related properties that are used to fill the DataSet and update a data source, and is implemented by .NET 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
Derivado
Implementações

Exemplos

O exemplo a seguir usa as classes derivadas SqlCommand , SqlDataAdapter e SqlConnection , para selecionar registros de uma fonte de dados.The following example uses the derived classes, SqlCommand, SqlDataAdapter and SqlConnection, to select records from a data source. DataSetEm seguida, o preenchimento é retornado.The filled DataSet is then returned. Para fazer isso, o método é passado como inicializado DataSet , uma cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução SELECT do Transact-SQL.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

Comentários

A IDbDataAdapter interface herda da IDataAdapter interface e permite que um objeto crie um DataAdapter projetado para uso com um banco de dados relacional.The IDbDataAdapter interface inherits from the IDataAdapter interface and allows an object to create a DataAdapter designed for use with a relational database. A IDbDataAdapter interface e, opcionalmente, a classe utilitária, DbDataAdapter , permitem que uma classe de herança implemente uma classe DataAdapter, que representa a ponte entre uma fonte de dados e um 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. Para obter mais informações sobre classes de DataAdapter, consulte Populando um conjunto de dados de um DataAdapter.For more information about DataAdapter classes, see Populating a DataSet from a DataAdapter. Para obter mais informações sobre como implementar provedores de dados de .NET Framework, consulte implementando um provedor de dados de .NET Framework.For more information about implementing .NET Framework data providers, see Implementing a .NET Framework Data Provider.

Um aplicativo não cria uma instância da IDbDataAdapter interface diretamente, mas cria uma instância de uma classe que herda 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.

As classes que herdam IDbDataAdapter devem implementar os membros herdados e normalmente definem membros adicionais para adicionar funcionalidade específica do provedor.Classes that inherit IDbDataAdapter must implement the inherited members, and typically define additional members to add provider-specific functionality. Por exemplo, a IDbDataAdapter interface define a SelectCommand propriedade, e a DbDataAdapter interface define um Fill método que usa um DataTable como parâmetro.For example, the IDbDataAdapter interface defines the SelectCommand property, and the DbDataAdapter interface defines a Fill method that takes a DataTable as a parameter. Por sua vez, a OleDbDataAdapter classe herda a SelectCommand propriedade e o Fill método e também define duas sobrecargas adicionais do Fill método que usam um objeto Recordset ADO como um parâmetro.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.

Notas aos Implementadores

Para promover a consistência entre .NET Framework provedores de dados, nomeie a classe herdeira no formato Prv DataAdapter, em que Prv é o prefixo uniforme fornecido a todas as classes em um namespace de provedor de dados .NET Framework específico.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. Por exemplo, Sql é o prefixo da SqlDataAdapter classe no System.Data.SqlClient namespace.For example, Sql is the prefix of the SqlDataAdapter class in the System.Data.SqlClient namespace.

Ao herdar da IDbDataAdapter interface, você deve implementar os seguintes construtores:When you inherit from the IDbDataAdapter interface, you should implement the following constructors:

ItemItem DescriçãoDescription
PrvDataAdapter()PrvDataAdapter() Inicializa uma nova instância da classe PrvDataAdapter.Initializes a new instance of the PrvDataAdapter class.
PrvDataAdapter (PrvCommand selectCommand)PrvDataAdapter(PrvCommand selectCommand) Inicializa uma nova instância da classe PrvDataAdapter com a instrução SQL SELECT especificada.Initializes a new instance of the PrvDataAdapter class with the specified SQL SELECT statement.
PrvDataAdapter (cadeia de caracteres selectCommandText, Cadeia de caracteres selectConnectionString)PrvDataAdapter(string selectCommandText, string selectConnectionString) Inicializa uma nova instância da classe PrvDataAdapter com uma instrução SQL SELECT e uma cadeia de conexão.Initializes a new instance of the PrvDataAdapter class with an SQL SELECT statement and a connection string.
PrvDataAdapter (cadeia de caracteres selectCommandText, PrvConnection selectConnection)PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inicializa uma nova instância da classe PrvDataAdapter com uma instrução SQL SELECT e um objeto PrvConnection.Initializes a new instance of the PrvDataAdapter class with an SQL SELECT statement and a PrvConnection object.

Propriedades

DeleteCommand

Obtém ou define uma instrução SQL para excluir registros do conjunto de dados.Gets or sets an SQL statement for deleting records from the data set.

InsertCommand

Obtém ou define uma instrução SQL usada para inserir novos registros na fonte de dados.Gets or sets an SQL statement used to insert new records into the data source.

MissingMappingAction

Indica ou especifica se colunas ou tabelas de origem não mapeadas são passadas com seus nomes de origem para serem filtradas ou para gerarem um erro.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.

(Herdado de IDataAdapter)
MissingSchemaAction

Indica ou especifica se as colunas, tabelas de origem ausentes e suas relações são adicionadas ao esquema do conjunto de dados, se são ignoradas ou se causam um erro a ser gerado.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.

(Herdado de IDataAdapter)
SelectCommand

Obtém ou define uma instrução SQL usada para selecionar registros na fonte de dados.Gets or sets an SQL statement used to select records in the data source.

TableMappings

Indica como uma tabela de origem é mapeada para uma tabela de conjunto de dados.Indicates how a source table is mapped to a dataset table.

(Herdado de IDataAdapter)
UpdateCommand

Obtém ou define uma instrução SQL usada para atualizar registros na fonte de dados.Gets or sets an SQL statement used to update records in the data source.

Métodos

Fill(DataSet)

Adiciona ou atualiza linhas no DataSet para corresponder àquelas na fonte de dados usando o nome DataSet e cria um DataTable chamado "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".

(Herdado de IDataAdapter)
FillSchema(DataSet, SchemaType)

Adiciona um DataTable com o nome “Tabela” ao DataSet especificado e configura o esquema para corresponder a eles na fonte de dados com base no SchemaType especificado.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.

(Herdado de IDataAdapter)
GetFillParameters()

Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT.Gets the parameters set by the user when executing an SQL SELECT statement.

(Herdado de IDataAdapter)
Update(DataSet)

Chama as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataSet especificado em um DataTable denominado “Tabela”.Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table".

(Herdado de IDataAdapter)

Aplica-se a