Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe OleDbDataAdapter

 

Representa um conjunto de comandos de dados e uma conexão de banco de dados que são usados para preencher o DataSet e atualizar a fonte de dados.

Namespace:   System.Data.OleDb
Assembly:  System.Data (em System.Data.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DataAdapter
        System.Data.Common.DbDataAdapter
          System.Data.OleDb.OleDbDataAdapter

public sealed class OleDbDataAdapter : DbDataAdapter, IDbDataAdapter, 
	IDataAdapter, ICloneable

NomeDescrição
System_CAPS_pubmethodOleDbDataAdapter()

Inicializa uma nova instância da classe OleDbDataAdapter.

System_CAPS_pubmethodOleDbDataAdapter(OleDbCommand)

Inicializa uma nova instância da classe OleDbDataAdapter com o OleDbCommand especificado como a propriedade SelectCommand.

System_CAPS_pubmethodOleDbDataAdapter(String, OleDbConnection)

Inicializa uma nova instância da classe OleDbDataAdapter com um SelectCommand.

System_CAPS_pubmethodOleDbDataAdapter(String, String)

Inicializa uma nova instância da classe OleDbDataAdapter com um SelectCommand.

NomeDescrição
System_CAPS_pubpropertyAcceptChangesDuringFill

Obtém ou define um valor que indica se AcceptChanges é chamado em um DataRow após ter sido adicionado ao DataTable durante alguma das operações de Preenchimento.(Herdado de DataAdapter.)

System_CAPS_pubpropertyAcceptChangesDuringUpdate

Obtém ou define se AcceptChanges é chamado durante um Update.(Herdado de DataAdapter.)

System_CAPS_pubpropertyContainer

Obtém o IContainer que contém o Component.(Herdado de Component.)

System_CAPS_pubpropertyContinueUpdateOnError

Obtém ou define um valor que especifica se uma exceção deve ser gerada quando for encontrado um erro durante uma atualização de linha.(Herdado de DataAdapter.)

System_CAPS_pubpropertyDeleteCommand

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

System_CAPS_protpropertyFillCommandBehavior

Obtém ou define o comportamento do comando usado para preencher o adaptador de dados.(Herdado de DbDataAdapter.)

System_CAPS_pubpropertyFillLoadOption

Obtém ou define o LoadOption que determina como o adaptador preenche o DataTable do DbDataReader.(Herdado de DataAdapter.)

System_CAPS_pubpropertyInsertCommand

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

System_CAPS_pubpropertyMissingMappingAction

Determina a ação a ser tomada quando os dados de entrada não têm uma tabela ou coluna correspondente.(Herdado de DataAdapter.)

System_CAPS_pubpropertyMissingSchemaAction

Determina a ação a ser tomada quando o esquema DataSet existente não coincide com os dados de entrada.(Herdado de DataAdapter.)

System_CAPS_pubpropertyReturnProviderSpecificTypes

Obtém ou define se o método Fill deve retornar valores específicos ao provedor ou valores comuns em conformidade com CLS.(Herdado de DataAdapter.)

System_CAPS_pubpropertySelectCommand

Obtém ou define uma instrução SQL ou um procedimento armazenado usado para selecionar registros na fonte de dados.

System_CAPS_pubpropertySite

Obtém ou define o ISite do Component.(Herdado de Component.)

System_CAPS_pubpropertyTableMappings

Obtém uma coleção que fornece o mapeamento mestre entre uma tabela de origem e um DataTable.(Herdado de DataAdapter.)

System_CAPS_pubpropertyUpdateBatchSize

Obtém ou define um valor que habilita ou desabilita o suporte ao processamento de lote e especifica o número de comandos que podem ser executadas em um lote.(Herdado de DbDataAdapter.)

System_CAPS_pubpropertyUpdateCommand

Obtém ou define uma instrução SQL ou um procedimento armazenado usado para atualizar registros na fonte de dados.

NomeDescrição
System_CAPS_pubmethodCreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.(Herdado de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libera todos os recursos usados pelo Component.(Herdado de Component.)

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_pubmethodFill(DataSet)

Adiciona ou atualiza linhas no DataSet.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodFill(DataSet, Int32, Int32, String)

Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando os nomes DataSet e DataTable.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodFill(DataSet, Object, String)

Adiciona ou atualiza linhas no DataSet para que correspondam às linhas em um objeto Recordset ou Record do ADO usando o DataSet, o objeto ADO e o nome da tabela de origem.

System_CAPS_pubmethodFill(DataSet, String)

Adiciona ou atualiza linhas no DataSet para corresponder às existentes na fonte de dados usando os nomes DataSet e DataTable.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodFill(DataTable)

Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando o nome DataTable.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodFill(DataTable, Object)

Adiciona ou atualiza linhas em um DataTable para que elas correspondam às linhas em um objeto Recordset ou Record ADO usando o DataTable especificado e objetos ADO.

System_CAPS_pubmethodFill(Int32, Int32, DataTable[])

Adiciona ou atualiza linhas em um DataTable para corresponder àquelas na fonte de dados, começando pelo registro especificado e recuperando até o número máximo de registros.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodFillSchema(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 DbDataAdapter.)

System_CAPS_pubmethodFillSchema(DataSet, SchemaType, String)

Adiciona um DataTable ao DataSet especificado e configura o esquema para corresponder à fonte de dados com base nos SchemaType e DataTable especificados.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodFillSchema(DataTable, SchemaType)

Configura o esquema do DataTable especificado com base no SchemaType especificado.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodGetFillParameters()

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

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera o objeto atual de serviço de vida útil que controla a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)

System_CAPS_pubmethodResetFillLoadOption()

Redefine FillLoadOption para seu estado padrão e causas DataAdapter.Fill obedeçam AcceptChangesDuringFill.(Herdado de DataAdapter.)

System_CAPS_pubmethodShouldSerializeAcceptChangesDuringFill()

Determina se o AcceptChangesDuringFill propriedade deve ser persistida.(Herdado de DataAdapter.)

System_CAPS_pubmethodShouldSerializeFillLoadOption()

Determina se o FillLoadOption propriedade deve ser persistida.(Herdado de DataAdapter.)

System_CAPS_pubmethodToString()

Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído.(Herdado de Component.)

System_CAPS_pubmethodUpdate(DataRow[])

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída na matriz especificada no DataSet.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodUpdate(DataSet)

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataSet especificado.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodUpdate(DataSet, String)

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataSet com o nome DataTable especificado.(Herdado de DbDataAdapter.)

System_CAPS_pubmethodUpdate(DataTable)

Atualiza os valores no banco de dados executando as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no DataTable especificado.(Herdado de DbDataAdapter.)

NomeDescrição
System_CAPS_pubeventDisposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose.(Herdado de Component.)

System_CAPS_pubeventFillError

É retornado quando ocorre um erro durante uma operação de preenchimento.(Herdado de DataAdapter.)

System_CAPS_pubeventRowUpdated

Ocorre durante a Update depois que um comando seja executado na fonte de dados. É feita a tentativa de atualizar. Portanto, o evento ocorre.

System_CAPS_pubeventRowUpdating

Ocorre durante a Update antes que um comando seja executado na fonte de dados. É feita a tentativa de atualizar. Portanto, o evento ocorre.

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Para obter uma descrição desse membro, consulte ICloneable.Clone.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataAdapter.TableMappings

Indica como uma tabela de origem é mapeada para uma tabela de conjunto de dados.(Herdado de DataAdapter.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataAdapter.DeleteCommand

Para obter uma descrição desse membro, consulte M:System.Data.IDbDataAdapter.DeleteCommand.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataAdapter.InsertCommand

Para obter uma descrição desse membro, consulte M:System.Data.IDbDataAdapter.InsertCommand.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataAdapter.SelectCommand

Para obter uma descrição desse membro, consulte M:System.Data.IDbDataAdapter.SelectCommand.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbDataAdapter.UpdateCommand

Para obter uma descrição desse membro, consulte M:System.Data.IDbDataAdapter.UpdateCommand.

The T:System.Data.OleDb.OleDbDataAdapter serves as a bridge between a T:System.Data.DataSet and data source for retrieving and saving data. The T:System.Data.OleDb.OleDbDataAdapter provides this bridge by using M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet) to load data from the data source into the T:System.Data.DataSet, and using M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet) to send changes made in the T:System.Data.DataSet back to the data source.

When the T:System.Data.OleDb.OleDbDataAdapter fills a T:System.Data.DataSet, it will create the appropriate tables and columns for the returned data if they do not already exist. However, primary key information is not included in the implicitly created schema unless the P:System.Data.Common.DataAdapter.MissingSchemaAction property is set to F:System.Data.MissingSchemaAction.AddWithKey. You may also have the T:System.Data.OleDb.OleDbDataAdapter create the schema of the T:System.Data.DataSet, including primary key information, before filling it with data using M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType). For more information, see Adding Existing Constraints to a DataSet.

Note that some OLE DB providers, including the MSDataShape provider, do not return base table or primary key information. Therefore, the T:System.Data.OleDb.OleDbDataAdapter cannot correctly set the P:System.Data.DataTable.PrimaryKey property on any created T:System.Data.DataTable. In these cases you should explicitly specify primary keys for tables in the T:System.Data.DataSet.

The T:System.Data.OleDb.OleDbDataAdapter also includes the P:System.Data.OleDb.OleDbDataAdapter.SelectCommand, P:System.Data.OleDb.OleDbDataAdapter.InsertCommand, P:System.Data.OleDb.OleDbDataAdapter.DeleteCommand, P:System.Data.OleDb.OleDbDataAdapter.UpdateCommand, and P:System.Data.Common.DataAdapter.TableMappings properties to facilitate the loading and updating of data.

When you create an instance of T:System.Data.OleDb.OleDbDataAdapter, properties are set to their initial values. For a list of these values, see the T:System.Data.OleDb.OleDbDataAdapter constructor.

The following example uses the T:System.Data.OleDb.OleDbCommand, T:System.Data.OleDb.OleDbDataAdapter and T:System.Data.OleDb.OleDbConnection, to select records from an Access data source, and populate a T:System.Data.DataSet with the selected rows. The filled T:System.Data.DataSet is then returned. To accomplish this, the method is passed an initialized T:System.Data.DataSet, a connection string, and a query string that is an SQL SELECT statement.

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID", 
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName", 
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID", 
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName", 
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID", 
        OleDbType.Char, 5, "CustomerID").SourceVersion = 
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID", 
        OleDbType.Char, 5, "CustomerID").SourceVersion = 
        DataRowVersion.Original;

    return adapter;
}

.NET Framework
Disponível desde 1.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: