DbDataAdapter 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.
Ajuda na implementação da IDbDataAdapter interface. Herdados de DbDataAdapter implementar um conjunto de funções para fornecer digitação forte, mas herdar a maior parte da funcionalidade necessária para implementar totalmente um DataAdapter.
public ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class DbDataAdapter abstract : System::Data::Common::DataAdapter, ICloneablepublic abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneable, System.Data.IDbDataAdapterpublic abstract class DbDataAdapter : System.Data.Common.DataAdapter, ICloneabletype DbDataAdapter = class
inherit DataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype DbDataAdapter = class
inherit DataAdapter
interface ICloneabletype DbDataAdapter = class
inherit DataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable, IDbDataAdapterPublic MustInherit Class DbDataAdapter
Inherits DataAdapter
Implements ICloneable- Herança
- Derivado
- Implementações
Comentários
A DbDataAdapter classe herda da DataAdapter classe e implementa a IDbDataAdapter interface. Ele ajuda uma classe a implementar um DataAdapter projetado para uso com um banco de dados relacional.
Um aplicativo não cria uma instância da DbDataAdapter classe diretamente, mas cria uma instância de uma classe que herda dela.
As classes herdadas DbDataAdapter devem implementar os membros herdados e, normalmente, definir membros adicionais para adicionar funcionalidade específica do provedor. Por exemplo, a DbDataAdapter classe define a SelectCommand propriedade e a DbDataAdapter classe define oito sobrecargas do Fill método. Por sua vez, a OleDbDataAdapter classe herda o Fill método e também define duas sobrecargas adicionais que Fill levam um objeto ADO Recordset como um parâmetro.
Notas aos Implementadores
Quando você herda da DbDataAdapter classe, recomendamos implementar os seguintes construtores:
| Item | Descrição |
|---|---|
| *Prv*DataAdapter() | Inicializa uma nova instância da classe *Prv*DataAdapter. |
| *Prv*DataAdapter(*Prv*Command *selectCommand*) | Inicializa uma nova instância da classe *Prv*DataAdapter com a instrução SQL SELECT especificada. |
| *Prv*DataAdapter(string *selectCommandText*, string *selectConnectionString*) | Inicializa uma nova instância da classe *Prv*DataAdapter com uma instrução SQL SELECT e uma cadeia de conexão. |
| *Prv*DataAdapter(string *selectCommandText*, *Prv*Connection *selectConnection*) | Inicializa uma nova instância da classe *Prv*DataAdapter com uma instrução SQL SELECT e um objeto *Prv*Connection. |
Para promover a consistência entre os provedores de dados do .NET Framework, você deve nomear a classe herdada no formato PrvDataAdapter, em que Prv é o prefixo uniforme fornecido a todas as classes em um namespace específico do provedor de dados do .NET Framework. Por exemplo, "Sql" é o prefixo da SqlDataAdapter classe no namespace System.Data.SqlClient .
Construtores
| Nome | Description |
|---|---|
| DbDataAdapter() |
Inicializa uma nova instância de uma classe DataAdapter . |
| DbDataAdapter(DbDataAdapter) |
Inicializa uma nova instância da |
Campos
| Nome | Description |
|---|---|
| DefaultSourceTableName |
O nome padrão usado pelo DataAdapter objeto para mapeamentos de tabela. |
Propriedades
| Nome | Description |
|---|---|
| AcceptChangesDuringFill |
Obtém ou define um valor que indica se AcceptChanges() é chamado em um DataRow após ele ser adicionado ao DataTable durante qualquer uma 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 gerar 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 um erro é encontrado durante uma atualização de linha. (Herdado de DataAdapter) |
| DeleteCommand |
Obtém ou define um comando 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 anexados a isso Component. (Herdado de Component) |
| FillCommandBehavior |
Obtém ou define o comportamento do comando usado para preencher o adaptador de dados. |
| FillLoadOption |
Obtém ou define o LoadOption que determina como o adaptador preenche o DataTableDbDataReader. (Herdado de DataAdapter) |
| InsertCommand |
Obtém ou define um comando 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 existente DataSet não corresponde aos dados de entrada. (Herdado de DataAdapter) |
| ReturnProviderSpecificTypes |
Obtém ou define se o |
| SelectCommand |
Obtém ou define um comando usado para selecionar registros na fonte de dados. |
| Site |
Obtém ou define o ISiteComponent. (Herdado de Component) |
| TableMappings |
Obtém uma coleção que fornece o mapeamento primário entre uma tabela de origem e uma DataTable. (Herdado de DataAdapter) |
| UpdateBatchSize |
Obtém ou define um valor que habilita ou desabilita o suporte ao processamento em lote e especifica o número de comandos que podem ser executados em um lote. |
| UpdateCommand |
Obtém ou define um comando usado para atualizar registros na fonte de dados. |
Métodos
| Nome | Description |
|---|---|
| AddToBatch(IDbCommand) |
Adiciona um IDbCommand ao lote atual. |
| ClearBatch() |
Remove todos os IDbCommand objetos do lote. |
| CloneInternals() |
Obsoleto.
Obsoleto.
Obsoleto.
Obsoleto.
Cria uma cópia dessa instância de 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. |
| CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Inicializa uma nova instância da classe RowUpdatingEventArgs. |
| 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. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| ExecuteBatch() |
Executa o lote atual. |
| Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) |
Adiciona ou atualiza linhas em um intervalo especificado para fazer a correspondência entre elas na fonte de dados usando os nomes da tabela de origem, a DataSet cadeia de comandos e o DataSet comportamento do comando. |
| Fill(DataSet, Int32, Int32, String) |
Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o nome e DataTable o DataSet nome. |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o DataSet, DataTablee IDataReader os nomes. |
| Fill(DataSet, String, IDataReader, Int32, Int32) |
Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o nome e DataTable o DataSet nome. (Herdado de DataAdapter) |
| Fill(DataSet, String) |
Adiciona ou atualiza linhas para DataSet corresponder àquelas na fonte de dados usando os nomes e DataTable os DataSet nomes. |
| Fill(DataSet) |
Adiciona ou atualiza linhas no DataSet. |
| Fill(DataTable, IDataReader) |
Adiciona ou atualiza linhas em uma DataTable para corresponder às da fonte de dados usando os nomes especificados DataTableIDataReader . |
| Fill(DataTable, IDataReader) |
Adiciona ou atualiza linhas para DataTable corresponder àquelas na fonte de dados usando o DataTable nome e o especificado IDataReader. (Herdado de DataAdapter) |
| Fill(DataTable, IDbCommand, CommandBehavior) |
Adiciona ou atualiza linhas em uma DataTable para corresponder àquelas na fonte de dados usando o especificado DataTablee CommandBehaviorIDbCommand . |
| Fill(DataTable) |
Adiciona ou atualiza linhas em um intervalo especificado para corresponder às DataSet da fonte de dados usando o DataTable nome. |
| Fill(DataTable[], IDataReader, Int32, Int32) |
Adiciona ou atualiza linhas em um intervalo especificado na coleção de objetos para corresponder às da fonte de DataTable dados. (Herdado de DataAdapter) |
| Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) |
Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o nome e DataTable o DataSet nome. |
| 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. |
| FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) |
Adiciona um DataTable ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base no especificado SchemaType. |
| FillSchema(DataSet, SchemaType, String, IDataReader) |
Adiciona um DataTable ao especificado DataSet. (Herdado de DataAdapter) |
| FillSchema(DataSet, SchemaType, String) |
Adiciona um DataTable ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base no especificado SchemaType e DataTable. |
| FillSchema(DataSet, SchemaType) |
Adiciona uma DataTable "Tabela" nomeada ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base na especificada SchemaType. |
| FillSchema(DataTable, SchemaType, IDataReader) |
Adiciona um DataTable ao especificado DataSet. (Herdado de DataAdapter) |
| FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) |
Configura o esquema do especificado DataTable com base nos valores especificados SchemaType, cadeia de caracteres de comando e CommandBehavior valores. |
| FillSchema(DataTable, SchemaType) |
Configura o esquema do especificado DataTable com base no especificado SchemaType. |
| GetBatchedParameter(Int32, Int32) |
Retorna um IDataParameter de um dos comandos no lote atual. |
| GetBatchedRecordsAffected(Int32, Int32, Exception) |
Retorna informações sobre uma tentativa de atualização individual em uma atualização em lote maior. |
| GetFillParameters() |
Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT. |
| 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 tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetService(Type) |
Retorna um objeto que representa um serviço fornecido pelo Component ou por sua 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. |
| InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| OnFillError(FillErrorEventArgs) |
Aciona o evento FillError. |
| OnFillError(FillErrorEventArgs) |
Invocado quando ocorre um erro durante um |
| OnRowUpdated(RowUpdatedEventArgs) |
Gera o |
| OnRowUpdating(RowUpdatingEventArgs) |
Gera o |
| ResetFillLoadOption() |
FillLoadOption Redefine para seu estado padrão e faz Fill(DataSet) com que ele seja respeitadoAcceptChangesDuringFill. (Herdado de DataAdapter) |
| ShouldSerializeAcceptChangesDuringFill() |
Determina se a AcceptChangesDuringFill propriedade deve ser mantida. (Herdado de DataAdapter) |
| ShouldSerializeFillLoadOption() |
Determina se a FillLoadOption propriedade deve ser mantida. (Herdado de DataAdapter) |
| ShouldSerializeTableMappings() |
Determina se um ou mais DataTableMapping objetos existem e eles devem ser mantidos. (Herdado de DataAdapter) |
| TerminateBatching() |
Termina o envio em lote para o 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[], 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 DataRow objetos especificada. |
| 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. |
| 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 nome especificado DataTable . |
| 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 especificado DataSet. |
| 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 especificado DataTable. |
Eventos
| Nome | Description |
|---|---|
| Disposed |
Ocorre quando o componente é descartado por uma chamada para o Dispose() método. (Herdado de Component) |
| FillError |
Retornado quando ocorre um erro durante uma operação de preenchimento. |
| FillError |
Retornado quando ocorre um erro durante uma operação de preenchimento. (Herdado de DataAdapter) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| ICloneable.Clone() |
Obsoleto.
Cria um novo objeto que é uma cópia da instância atual. |
| 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 |
Obtém ou define uma instrução SQL para excluir registros do conjunto de dados. |
| IDbDataAdapter.InsertCommand |
Obtém ou define uma instrução SQL usada para inserir novos registros na fonte de dados. |
| IDbDataAdapter.SelectCommand |
Obtém ou define uma instrução SQL usada para selecionar registros na fonte de dados. |
| IDbDataAdapter.UpdateCommand |
Obtém ou define uma instrução SQL usada para atualizar registros na fonte de dados. |
