OleDbDataAdapter Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapterpublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneablepublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdaptertype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapterPublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter- Herança
- Implementações
Exemplos
O exemplo a seguir usa , OleDbCommandOleDbDataAdapter e OleDbConnection, para selecionar registros de uma fonte de dados do Access e preencher um DataSet com as linhas selecionadas. 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 SQL SELECT.
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;
}
Public Function CreateDataAdapter(ByVal selectCommand As String, _
ByVal connection As OleDbConnection) As OleDbDataAdapter
Dim adapter As OleDbDataAdapter = _
New OleDbDataAdapter(selectCommand, connection)
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
' Create the 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
End Function
Comentários
O OleDbDataAdapter serve como uma ponte entre uma DataSet fonte de dados e para recuperar e salvar dados. O OleDbDataAdapter fornece essa ponte usando Fill para carregar dados da fonte de dados para o DataSete usando Update para enviar alterações feitas na DataSet parte de trás para a fonte de dados.
Quando o OleDbDataAdapter preencher um DataSet, ele criará as tabelas e colunas apropriadas para os dados retornados se eles ainda não existirem. No entanto, as informações de chave primária não são incluídas no esquema criado implicitamente, a menos que a MissingSchemaAction propriedade esteja definida como AddWithKey. Você também pode ter a criação OleDbDataAdapter do esquema do , incluindo informações de DataSetchave primária, antes de preenchê-lo com dados usando FillSchema. Para obter mais informações, consulte Adicionando restrições existentes a um Conjunto de Dados.
Observe que alguns provedores OLE DB, incluindo o provedor MSDataShape, não retornam informações de tabela base ou chave primária. Portanto, o OleDbDataAdapter não pode definir corretamente a PrimaryKey propriedade em nenhum criado DataTable. Nesses casos, você deve especificar explicitamente as chaves primárias para tabelas no DataSet.
O OleDbDataAdapter também inclui as SelectCommandpropriedades , InsertCommand, DeleteCommand, UpdateCommande TableMappings para facilitar o carregamento e a atualização de dados.
Quando você cria uma instância de OleDbDataAdapter, as propriedades são definidas como seus valores iniciais. Para obter uma lista desses valores, consulte o OleDbDataAdapter construtor .
Construtores
| OleDbDataAdapter() |
Inicializa uma nova instância da classe OleDbDataAdapter. |
| OleDbDataAdapter(OleDbCommand) |
Inicializa uma nova instância da classe OleDbDataAdapter com o OleDbCommand especificado como a propriedade SelectCommand. |
| OleDbDataAdapter(String, OleDbConnection) |
Inicializa uma nova instância da classe OleDbDataAdapter com um SelectCommand. |
| OleDbDataAdapter(String, String) |
Inicializa uma nova instância da classe OleDbDataAdapter com um SelectCommand. |
Campos
| DefaultSourceTableName |
O nome padrão usado pelo objeto DataAdapter para mapeamentos de tabela. (Herdado de DbDataAdapter) |
Propriedades
| AcceptChangesDuringFill |
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) |
| AcceptChangesDuringUpdate |
Obtém ou define se AcceptChanges() é chamado durante um Update(DataSet). (Herdado de DataAdapter) |
| CanRaiseEvents |
Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component) |
| Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
| ContinueUpdateOnError |
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) |
| DeleteCommand |
Obtém ou define uma instrução SQL ou um procedimento armazenado para excluir registros do conjunto de dados. |
| DesignMode |
Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component) |
| Events |
Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component) |
| FillCommandBehavior |
Obtém ou define o comportamento do comando usado para preencher o adaptador de dados. (Herdado de DbDataAdapter) |
| FillLoadOption |
Obtém ou define o LoadOption que determina como o adaptador preenche o DataTable do DbDataReader. (Herdado de DataAdapter) |
| InsertCommand |
Obtém ou define uma instrução SQL ou um procedimento armazenado usado para inserir novos registros na fonte de dados. |
| MissingMappingAction |
Determina a ação a ser tomada quando os dados de entrada não têm uma tabela ou coluna correspondente. (Herdado de DataAdapter) |
| MissingSchemaAction |
Determina a ação a ser tomada quando o esquema DataSet existente não coincide com os dados de entrada. (Herdado de DataAdapter) |
| ReturnProviderSpecificTypes |
Obtém ou define se o método |
| SelectCommand |
Obtém ou define uma instrução SQL ou um procedimento armazenado usado para selecionar registros na fonte de dados. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| TableMappings |
Obtém uma coleção que fornece o mapeamento primário entre uma tabela de origem e um DataTable. (Herdado de DataAdapter) |
| UpdateBatchSize |
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) |
| UpdateCommand |
Obtém ou define uma instrução SQL ou um procedimento armazenado usado para atualizar registros na fonte de dados. |
Métodos
| AddToBatch(IDbCommand) |
Adiciona um IDbCommand ao lote atual. (Herdado de DbDataAdapter) |
| ClearBatch() |
Remove todos os objetos IDbCommand do lote. (Herdado de DbDataAdapter) |
| CloneInternals() |
Obsoleto.
Obsoleto.
Obsoleto.
Obsoleto.
Cria uma cópia dessa instância do DataAdapter. (Herdado de DataAdapter) |
| CreateObjRef(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) |
| CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inicializa uma nova instância da classe RowUpdatedEventArgs. (Herdado de DbDataAdapter) |
| CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inicializa uma nova instância da classe RowUpdatingEventArgs. (Herdado de DbDataAdapter) |
| CreateTableMappings() |
Cria um novo DataTableMappingCollection. (Herdado de DataAdapter) |
| Dispose() |
Libera todos os recursos usados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DbDataAdapter e opcionalmente libera os recursos gerenciados. (Herdado de DbDataAdapter) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| ExecuteBatch() |
Executa o lote atual. (Herdado de DbDataAdapter) |
| Fill(DataSet) |
Adiciona ou atualiza linhas no DataSet. (Herdado de DbDataAdapter) |
| Fill(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) |
| Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) |
Adiciona ou atualiza linhas em um intervalo especificado no DataSet para corresponder àquelas na fonte de dados usando o DataSet e nomes da tabela de origem, a cadeia de comando e o comportamento do comando. (Herdado de DbDataAdapter) |
| Fill(DataSet, Object, String) |
Adiciona ou atualiza linhas no DataSet para que correspondam às linhas em um objeto |
| Fill(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) |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
Adiciona ou atualiza linhas em um intervalo especificado no DataSet para que correspondam àquelas na fonte de dados usando os nomes DataSet, DataTable e IDataReader. (Herdado de DbDataAdapter) |
| Fill(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) |
| Fill(DataTable, IDataReader) |
Adiciona ou atualiza linhas em uma DataTable para que correspondam àquelas na fonte de dados usando os nomes DataTable e IDataReader especificados. (Herdado de DbDataAdapter) |
| Fill(DataTable, IDbCommand, CommandBehavior) |
Adiciona ou atualiza linhas em um DataTable para corresponder às existentes na fonte de dados usando o DataTable, IDbCommand e CommandBehavior especificados. (Herdado de DbDataAdapter) |
| Fill(DataTable, Object) |
Adiciona ou atualiza linhas em um DataTable para que elas correspondam às linhas em um objeto |
| Fill(DataTable[], IDataReader, Int32, Int32) |
Adiciona ou atualiza as linhas em um intervalo especificado na coleção de objetos DataTable para corresponder àquelas na fonte de dados. (Herdado de DataAdapter) |
| Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) |
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) |
| Fill(Int32, Int32, DataTable[]) |
Adiciona ou atualiza linhas em um ou mais DataTable objetos para corresponder às da fonte de dados começando no registro especificado e recuperando até o número máximo de registros especificado. (Herdado de DbDataAdapter) |
| 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 DbDataAdapter) |
| FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) |
Adiciona um DataTable ao DataSet especificado e configura o esquema para corresponder à fonte de dados com base no SchemaType especificado. (Herdado de DbDataAdapter) |
| FillSchema(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) |
| FillSchema(DataSet, SchemaType, String, IDataReader) |
Adiciona um DataTable ao DataSet especificado. (Herdado de DataAdapter) |
| FillSchema(DataTable, SchemaType) |
Configura o esquema do DataTable especificado com base no SchemaType especificado. (Herdado de DbDataAdapter) |
| FillSchema(DataTable, SchemaType, IDataReader) |
Adiciona um DataTable ao DataSet especificado. (Herdado de DataAdapter) |
| FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) |
Configura o esquema do DataTable especificado com base no SchemaType, na cadeia de caracteres de comando e nos valores CommandBehavior especificados. (Herdado de DbDataAdapter) |
| GetBatchedParameter(Int32, Int32) |
Retorna um IDataParameter de um dos comandos no lote atual. (Herdado de DbDataAdapter) |
| GetBatchedRecordsAffected(Int32, Int32, Exception) |
Retorna informações sobre uma tentativa de atualização individual dentro de uma atualização em lote maior. (Herdado de DbDataAdapter) |
| GetFillParameters() |
Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT. (Herdado de DbDataAdapter) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject) |
| GetService(Type) |
Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| HasTableMappings() |
Indica se um DataTableMappingCollection foi criado. (Herdado de DataAdapter) |
| InitializeBatching() |
Inicializa o envio em lote para o DbDataAdapter. (Herdado de DbDataAdapter) |
| InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
| OnFillError(FillErrorEventArgs) |
Aciona o evento FillError. (Herdado de DbDataAdapter) |
| OnRowUpdated(RowUpdatedEventArgs) |
Gera o evento |
| OnRowUpdating(RowUpdatingEventArgs) |
Gera o evento |
| ResetFillLoadOption() |
Redefine FillLoadOption para seu estado padrão e faz com que Fill(DataSet) honre AcceptChangesDuringFill. (Herdado de DataAdapter) |
| ShouldSerializeAcceptChangesDuringFill() |
Determina se a propriedade AcceptChangesDuringFill deve ser persistida. (Herdado de DataAdapter) |
| ShouldSerializeFillLoadOption() |
Determina se a propriedade FillLoadOption deve ser persistida. (Herdado de DataAdapter) |
| ShouldSerializeTableMappings() |
Determina se um ou mais objetos DataTableMapping existem e se devem ser persistidos. (Herdado de DataAdapter) |
| TerminateBatching() |
Encerra o envio em lote para o DbDataAdapter. (Herdado de DbDataAdapter) |
| ToString() |
Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component) |
| Update(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) |
| Update(DataRow[], DataTableMapping) |
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 de objetos DataRow especificada. (Herdado de DbDataAdapter) |
| Update(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) |
| Update(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) |
| Update(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) |
Eventos
| Disposed |
Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component) |
| FillError |
É retornado quando ocorre um erro durante uma operação de preenchimento. (Herdado de DbDataAdapter) |
| RowUpdated |
Ocorre durante o Update(DataSet), após um comando ser executado na fonte de dados. Realiza-se a tentativa de atualização. Portanto, o evento ocorre. |
| RowUpdating |
Ocorre durante o Update(DataSet), após um comando ser executado com relação à fonte de dados. Realiza-se a tentativa de atualização. Portanto, o evento ocorre. |
Implantações explícitas de interface
| ICloneable.Clone() |
Para obter uma descrição desse membro, confira Clone(). |
| IDataAdapter.TableMappings |
Obtém uma coleção que indica como uma tabela de origem é mapeada para uma tabela de conjunto de dados. (Herdado de DataAdapter) |
| IDbDataAdapter.DeleteCommand |
Para obter uma descrição desse membro, confira DeleteCommand. |
| IDbDataAdapter.InsertCommand |
Para obter uma descrição desse membro, confira InsertCommand. |
| IDbDataAdapter.SelectCommand |
Para obter uma descrição desse membro, confira SelectCommand. |
| IDbDataAdapter.UpdateCommand |
Para obter uma descrição desse membro, confira UpdateCommand. |
Aplica-se a
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de