DataAdapter 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 SQL e uma conexão de banco de dados usada para preencher DataSet e atualizar a fonte de dados.
public ref class DataAdapter abstract : System::ComponentModel::Component, System::Data::IDataAdapter
public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter
public abstract class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
type DataAdapter = class
inherit Component
interface IDataAdapter
Public MustInherit Class DataAdapter
Inherits Component
Implements IDataAdapter
Public Class DataAdapter
Inherits Component
Implements IDataAdapter
- Herança
- Derivado
- Implementações
Comentários
O DataAdapter serve como uma ponte entre uma fonte de dados e uma DataSet fonte de dados para recuperar e salvar dados. A DataAdapter ponte é fornecida pelo mapeamento Fill, que altera os dados na DataSet correspondência dos dados na fonte de dados e Update, que altera os dados na fonte de dados para corresponder aos dados na DataSet.
Se você estiver se conectando a um banco de dados SQL Server, poderá aumentar o desempenho geral usando o SqlDataAdapter juntamente com seus objetos SqlCommand e SqlConnection associados. Para fontes de dados compatíveis com OLE DB, use o DataAdapter com seus objetos e OleDbConnection associadosOleDbCommand. Para fontes de dados com suporte ODBC, use o DataAdapter com seus objetos e OdbcConnection associadosOdbcCommand. Para bancos de dados Oracle, use com seus DataAdapter objetos e OracleConnection associadosOracleCommand.
Quando uma instância é criada, as propriedades de DataAdapter leitura/gravação são definidas como valores iniciais. Para obter uma lista desses valores, consulte o DataAdapter construtor.
Construtores
| Nome | Description |
|---|---|
| DataAdapter() |
Inicializa uma nova instância da classe DataAdapter. |
| DataAdapter(DataAdapter) |
Inicializa uma nova instância da DataAdapter classe de um objeto existente do mesmo tipo. |
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 . |
| AcceptChangesDuringUpdate |
Obtém ou define se AcceptChanges() é chamado durante um Update(DataSet). |
| 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. |
| 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) |
| FillLoadOption |
Obtém ou define o LoadOption que determina como o adaptador preenche o DataTableDbDataReader. |
| MissingMappingAction |
Determina a ação a ser tomada quando os dados de entrada não têm uma tabela ou coluna correspondente. |
| MissingSchemaAction |
Determina a ação a ser tomada quando o esquema existente DataSet não corresponde aos dados de entrada. |
| ReturnProviderSpecificTypes |
Obtém ou define se o |
| 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 uma DataTable. |
Métodos
| Nome | Description |
|---|---|
| CloneInternals() |
Obsoleto.
Obsoleto.
Obsoleto.
Cria uma cópia dessa instância 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) |
| CreateTableMappings() |
Cria um novo DataTableMappingCollection. |
| Dispose() |
Libera todos os recursos usados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DataAdapter e, opcionalmente, libera os recursos gerenciados. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| 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 DataSet o DataTable nome. |
| Fill(DataSet) |
Adiciona ou atualiza linhas para DataSet corresponder àquelas na fonte de dados. |
| Fill(DataTable, IDataReader) |
Adiciona ou atualiza linhas para DataTable corresponder àquelas na fonte de dados usando o DataTable nome e o especificado IDataReader. |
| 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. |
| FillSchema(DataSet, SchemaType, String, IDataReader) | |
| FillSchema(DataSet, SchemaType) |
Adiciona um DataTable ao especificado DataSet e configura o esquema para corresponder ao da fonte de dados com base no especificado SchemaType. |
| FillSchema(DataTable, SchemaType, IDataReader) | |
| GetFillParameters() |
Obtém os parâmetros definidos pelo usuário ao executar uma instrução SQL SELECT. |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
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. |
| InitializeLifetimeService() |
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) |
Invocado quando ocorre um erro durante um |
| ResetFillLoadOption() |
FillLoadOption Redefine para seu estado padrão e faz Fill(DataSet) com que ele seja respeitadoAcceptChangesDuringFill. |
| ShouldSerializeAcceptChangesDuringFill() |
Determina se a AcceptChangesDuringFill propriedade deve ser mantida. |
| ShouldSerializeFillLoadOption() |
Determina se a FillLoadOption propriedade deve ser mantida. |
| ShouldSerializeTableMappings() |
Determina se um ou mais DataTableMapping objetos existem e eles devem ser mantidos. |
| 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(DataSet) |
Chama as respectivas instruções INSERT, UPDATE ou DELETE para cada linha inserida, atualizada ou excluída no especificado DataSet de uma DataTable "Tabela". |
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. |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IDataAdapter.TableMappings |
Obtém uma coleção que indica como uma tabela de origem é mapeada para uma tabela de conjunto de dados. |