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.

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. Em seguida, o preenchido DataSet é retornado. Para fazer isso, o método é passado um inicializado DataSet, uma cadeia de conexão e uma cadeia de caracteres de consulta que é uma instrução SELECT Transact-SQL.

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. A IDbDataAdapter interface e, opcionalmente, a classe de utilitário , DbDataAdapterpermitem que uma classe herdada implemente uma classe DataAdapter, que representa a ponte entre uma fonte de dados e uma DataSet. Para obter mais informações sobre classes DataAdapter, consulte Populando um DataSet de um DataAdapter. Para obter mais informações sobre como implementar provedores de dados .NET Framework, consulte Implementando um provedor de dados .NET Framework.

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.

As classes herdadas IDbDataAdapter devem implementar os membros herdados e, normalmente, definir membros adicionais para adicionar funcionalidade específica do provedor. 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. 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 tomam um objeto Recordset do ADO como um parâmetro.

Notas aos Implementadores

Para promover a consistência entre .NET Framework provedores de dados, nomeie a classe herdada no formato Prv DataAdapter, em Prv que é o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados .NET Framework. Por exemplo, Sql é o prefixo da SqlDataAdapter classe no System.Data.SqlClient namespace .

Ao herdar da IDbDataAdapter interface , você deve implementar os seguintes construtores:

Item Descrição
PrvDataAdapter() Inicializa uma nova instância da classe PrvDataAdapter.
PrvDataAdapter(PrvCommand selectCommand) Inicializa uma nova instância da classe PrvDataAdapter com a instrução SQL SELECT especificada.
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.
PrvDataAdapter(string selectCommandText, PrvConnection selectConnection) Inicializa uma nova instância da classe PrvDataAdapter com uma instrução SQL SELECT e um objeto PrvConnection.

Propriedades

DeleteCommand

Obtém ou define uma instrução SQL para excluir registros do conjunto de dados.

InsertCommand

Obtém ou define uma instrução SQL usada para inserir novos registros na fonte de dados.

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.

(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.

(Herdado de IDataAdapter)
SelectCommand

Obtém ou define uma instrução SQL usada para selecionar registros na fonte de dados.

TableMappings

Obtém uma coleção que indica como uma tabela de origem é mapeada para uma tabela de conjunto de dados.

(Herdado de IDataAdapter)
UpdateCommand

Obtém ou define uma instrução SQL usada para atualizar registros na fonte de dados.

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".

(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.

(Herdado de IDataAdapter)
GetFillParameters()

Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT.

(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”.

(Herdado de IDataAdapter)

Aplica-se a