Compartilhar via


System.Data Namespace

Fornece acesso a classes que representam a arquitetura ADO.NET. ADO.NET permite criar componentes que gerenciam dados com eficiência de várias fontes de dados.

Classes

Nome Description
Constraint

Representa uma restrição que pode ser imposta em um ou mais DataColumn objetos.

ConstraintCollection

Representa uma coleção de restrições para um DataTable.

ConstraintException

Representa a exceção gerada ao tentar uma ação que viola uma restrição.

DataColumn

Representa o esquema de uma coluna em um DataTable.

DataColumnChangeEventArgs

Fornece dados para o evento ColumnChanging.

DataColumnCollection

Representa uma coleção de DataColumn objetos para um DataTable.

DataException

Representa a exceção gerada quando erros são gerados usando ADO.NET componentes.

DataReaderExtensions

Fornece métodos de extensão para DbDataReader.

DataRelation

Representa uma relação pai/filho entre dois DataTable objetos.

DataRelationCollection

Representa a coleção de DataRelation objetos para isso DataSet.

DataRow

Representa uma linha de dados em um DataTable.

DataRowBuilder

O DataRowBuilder tipo dá suporte à infraestrutura do .NET e não se destina a ser usado diretamente do seu código.

DataRowChangeEventArgs

Fornece dados para o RowChanged, , OnRowDeleting(DataRowChangeEventArgs)RowChanginge OnRowDeleted(DataRowChangeEventArgs) eventos.

DataRowCollection

Representa uma coleção de linhas para um DataTable.

DataRowComparer

Retorna uma instância singleton da DataRowComparer<TRow> classe.

DataRowComparer<TRow>

Compara dois DataRow objetos para equivalência usando a comparação baseada em valor.

DataRowExtensions

Define os métodos de extensão para a DataRow classe. Esta é uma classe estática.

DataRowView

Representa uma exibição personalizada de um DataRow.

DataSet

Representa um cache de dados na memória.

DataSetSchemaImporterExtension

Esse membro dá suporte à infraestrutura do .NET Framework e não se destina a ser usado diretamente do seu código.

DataSysDescriptionAttribute

Marca uma propriedade, evento ou extensor com uma descrição. Os designers visuais podem exibir essa descrição ao referenciar o membro.

DataTable

Representa uma tabela de dados na memória.

DataTableClearEventArgs

Fornece dados para o Clear() método.

DataTableCollection

Representa a coleção de tabelas para o DataSet.

DataTableExtensions

Define os métodos de extensão para a DataTable classe. DataTableExtensions é uma classe estática.

DataTableNewRowEventArgs

Fornece dados para o NewRow() método.

DataTableReader

O DataTableReader obtém o conteúdo de um ou mais objetos DataTable na forma de um ou mais conjuntos de resultados somente leitura de somente avanço.

DataView

Representa uma exibição vinculável e personalizada de um DataTable modo de classificação, filtragem, pesquisa, edição e navegação. O DataView não armazena dados, mas representa uma exibição conectada de seu correspondente DataTable. As alterações nos DataViewdados afetarão o DataTable. As alterações nos DataTabledados afetarão todos os DataViewassociados a ele.

DataViewManager

Contém um padrão DataViewSettingCollection para cada DataTable um em um DataSet.

DataViewSetting

Representa as configurações padrão para ApplyDefaultSort, DataViewManager, , RowFilter, RowStateFiltere SortTable para DataViews criados a partir do DataViewManager.

DataViewSettingCollection

Contém uma coleção somente leitura de DataViewSetting objetos para cada DataTable um em um DataSet.

DBConcurrencyException

A exceção gerada pela operação de inserção, atualização ou exclusão se o número de linhas afetadas for igual a DataAdapter zero.

DeletedRowInaccessibleException

Representa a exceção gerada quando uma ação é testada em uma DataRow que foi excluída.

DuplicateNameException

Representa a exceção gerada quando um nome de objeto de banco de dados duplicado é encontrado durante uma operação de adição em um DataSet objeto -related.

EntityCommandCompilationException

Representa erros que ocorrem durante a compilação de comandos; quando não foi possível produzir uma árvore de comandos para representar o texto do comando.

EntityCommandExecutionException

Representa erros que ocorrem quando o provedor de armazenamento subjacente não pôde executar o comando especificado. Essa exceção geralmente encapsula uma exceção específica do provedor.

EntityException

Representa erros relacionados ao Entity Framework que ocorrem no EntityClient namespace. É EntityException a classe base para todas as exceções do Entity Framework geradas pelo EntityClient.

EntityKey

Fornece uma referência durável a um objeto que é uma instância de um tipo de entidade.

EntityKeyMember

Representa um nome de chave e um par de valores que faz parte de um EntityKey.

EntitySqlException

Representa erros que ocorrem ao analisar o texto do comando Entity SQL. Essa exceção é gerada quando regras sintacticas ou semânticas são violadas.

EnumerableRowCollection

Representa uma coleção de DataRow objetos retornados de uma consulta LINQ para DataSet. Essa API dá suporte à infraestrutura do .NET e não se destina a ser usada diretamente do seu código.

EnumerableRowCollection<TRow>

Representa uma coleção de DataRow objetos retornados de uma consulta.

EnumerableRowCollectionExtensions

Contém os métodos de extensão para as classes de coleta de linhas de dados.

EvaluateException

Representa a exceção gerada quando a Expression propriedade de um DataColumn não pode ser avaliada.

FillErrorEventArgs

Fornece dados para o FillError evento de um DbDataAdapter.

ForeignKeyConstraint

Representa uma restrição de ação imposta em um conjunto de colunas em uma relação chave primária/chave estrangeira quando um valor ou linha é excluído ou atualizado.

InRowChangingEventException

Representa a exceção gerada quando você chama o EndEdit() método dentro do RowChanging evento.

InternalDataCollectionBase

Fornece a funcionalidade base para criar coleções.

InvalidCommandTreeException

A exceção gerada para indicar que uma árvore de comandos é inválida. No momento, essa exceção não é lançada em nenhum lugar no Entity Framework.

InvalidConstraintException

Representa a exceção gerada ao tentar criar ou acessar incorretamente uma relação.

InvalidExpressionException

Representa a exceção gerada quando você tenta adicionar um DataColumn que contém um inválido Expression a um DataColumnCollection.

MappingException

A exceção gerada quando as solicitações de serviço relacionadas ao mapeamento falham.

MergeFailedEventArgs

Ocorre quando um destino e uma origem DataRow têm o mesmo valor de chave primária e a EnforceConstraints propriedade é definida como true.

MetadataException

A exceção gerada quando as solicitações de serviço relacionadas a metadados falham.

MissingPrimaryKeyException

Representa a exceção gerada quando você tenta acessar uma linha em uma tabela que não tem chave primária.

NoNullAllowedException

Representa a exceção gerada quando você tenta inserir um valor nulo em uma coluna em AllowDBNull que é definido falsecomo .

ObjectNotFoundException

A exceção gerada quando um objeto não está presente.

OperationAbortedException

Essa exceção é gerada quando uma operação em andamento é anulada pelo usuário.

OptimisticConcurrencyException

A exceção gerada quando ocorre uma violação de simultaneidade otimista.

OrderedEnumerableRowCollection<TRow>

Representa uma coleção de objetos ordenados DataRow retornados de uma consulta.

PropertyCollection

Representa uma coleção de propriedades que podem ser adicionadas a DataColumn, DataSetou DataTable.

PropertyConstraintException

Classe de exceção de restrição de propriedade. Observe que essa classe tem estado, portanto, se você alterar até mesmo seus internos, pode ser uma alteração significativa.

ProviderIncompatibleException

A exceção gerada quando o provedor de dados subjacente é incompatível com o Entity Framework.

ReadOnlyException

Representa a exceção gerada quando você tenta alterar o valor de uma coluna somente leitura.

RowNotInTableException

Representa a exceção gerada quando você tenta executar uma operação em uma DataRow que não está em um DataTable.

StateChangeEventArgs

Fornece dados para o evento de alteração de estado de um provedor de dados .NET.

StatementCompletedEventArgs

Fornece informações adicionais para o StatementCompleted evento.

StrongTypingException

A exceção gerada por um tipo DataSet forte quando o usuário acessa um DBNull valor.

SyntaxErrorException

Representa a exceção gerada quando a Expression propriedade de um DataColumn contém um erro de sintaxe.

TypedDataSetGenerator

Usado para criar um tipo DataSetforte.

TypedDataSetGeneratorException

A exceção gerada quando ocorre um conflito de nome ao gerar um tipo DataSetforte.

TypedTableBase<T>

Esse tipo é usado como uma classe base para geração deDataTable objeto tipado pelo Visual Studio e a ferramenta .NET Framework XSD.exe e não se destina a ser usado diretamente do seu código.

TypedTableBaseExtensions

Contém os métodos de extensão da TypedTableBase<T> classe.

UniqueConstraint

Representa uma restrição em um conjunto de colunas em que todos os valores devem ser exclusivos.

UpdateException

A exceção gerada quando as modificações em instâncias de objeto não podem ser mantidas na fonte de dados.

VersionNotFoundException

Representa a exceção gerada quando você tenta retornar uma versão de uma DataRow que foi excluída.

Interfaces

Nome Description
IColumnMapping

Associa uma coluna de fonte de dados a uma DataSet coluna e é implementada pela DataColumnMapping classe, que é usada em comum pelos provedores de dados do .NET.

IColumnMappingCollection

Contém uma coleção de objetos DataColumnMapping e é implementado pelo DataColumnMappingCollection, que é usado em comum pelos provedores de dados do .NET.

IDataAdapter

Permite que um objeto implemente um DataAdapter e represente um conjunto de métodos e propriedades relacionadas à ação de mapeamento que são usadas para preencher e atualizar uma DataSet fonte de dados e atualizar.

IDbDataAdapter as instâncias são para fontes de dados que são (ou se assemelham) a bancos de dados relacionais com comandos textuais (como Transact-SQL), enquanto IDataAdapter as instâncias podem usar qualquer tipo de fonte de dados.

IDataParameter

Representa um parâmetro para um objeto Command e, opcionalmente, seu mapeamento para DataSet colunas; e é implementado por provedores de dados .NET que acessam fontes de dados.

IDataParameterCollection

Coleta todos os parâmetros relevantes para um objeto Command e seus mapeamentos para DataSet colunas e é implementado por provedores de dados .NET que acessam fontes de dados.

IDataReader

Fornece um meio de ler um ou mais fluxos somente de encaminhamento de conjuntos de resultados obtidos executando um comando em uma fonte de dados e é implementado por provedores de dados .NET que acessam bancos de dados relacionais.

IDataRecord

Fornece acesso aos valores de coluna em cada linha para um DataReadere é implementado por provedores de dados do .NET que acessam bancos de dados relacionais.

IDbCommand

Representa uma instrução SQL executada enquanto está conectada a uma fonte de dados e é implementada por provedores de dados .NET que acessam bancos de dados relacionais.

IDbConnection

Representa uma conexão aberta com uma fonte de dados e é implementada por provedores de dados .NET que acessam bancos de dados relacionais.

IDbDataAdapter

Representa um conjunto de propriedades relacionadas a comandos que são usadas para preencher DataSet e atualizar uma fonte de dados e é implementado por provedores de dados .NET que acessam bancos de dados relacionais.

IDbDataParameter

Usado pelos Designers de Dados do .NET do Visual Basic para representar um parâmetro para um objeto Command e, opcionalmente, seu mapeamento para DataSet colunas.

IDbTransaction

Representa uma transação a ser executada em uma fonte de dados e é implementada por provedores de dados do .NET que acessam bancos de dados relacionais.

IExtendedDataRecord

Fornece acesso aos valores de coluna dentro de cada linha de um DbDataRecord para um DbDataReader.

ITableMapping

Associa uma tabela de origem DataTableMapping a uma tabela em uma DataSete é implementada pela classe, que é usada em comum pelos provedores de dados do .NET.

ITableMappingCollection

Contém uma coleção de objetos TableMapping e é implementado pelo DataTableMappingCollection. que é usado em comum por provedores de dados .NET.

Enumerações

Nome Description
AcceptRejectRule

Determina a ação que ocorre quando o método AcceptChanges() ou RejectChanges() é invocado em um DataTable com um ForeignKeyConstraint.

CommandBehavior

Fornece uma descrição dos resultados da consulta e seu efeito no banco de dados.

CommandType

Especifica como uma cadeia de caracteres de comando é interpretada.

ConflictOption

Especifica como as alterações conflitantes na fonte de dados serão detectadas e resolvidas.

ConnectionState

Descreve o estado atual da conexão com uma fonte de dados.

DataRowAction

Descreve uma ação executada em um DataRow.

DataRowState

Obtém o estado de um objeto DataRow.

DataRowVersion

Descreve a versão de um DataRow.

DataSetDateTime

Descreve o formato de serialização para colunas de DateTime em um DataSet.

DataViewRowState

Descreve a versão dos dados em um DataRow.

DbType

Especifica o tipo de dados de um campo, uma propriedade ou um objeto Parameter de um provedor de dados .NET.

EntityState

O estado de um objeto de entidade.

IsolationLevel

Especifica o comportamento de bloqueio de transação para a conexão.

KeyRestrictionBehavior

Identifica uma lista de parâmetros de cadeia de conexão identificados pela propriedade KeyRestrictions que são permitidos ou não permitidos.

LoadOption

Controla como os valores da fonte de dados serão aplicados a linhas existentes ao usar o método Load ou Load.

MappingType

Especifica como um DataColumn é mapeado.

MissingMappingAction

Determina a ação que ocorre quando um mapeamento está ausente de uma tabela de origem ou de uma coluna de origem.

MissingSchemaAction

Especifica a ação a ser executada ao adicionar dados ao DataSet e o DataTable ou DataColumn necessário está ausente.

ParameterDirection

Especifica o tipo de um parâmetro em uma consulta relativa ao DataSet.

PropertyAttributes

Especifica os atributos de uma propriedade.

Rule

Indica a ação que ocorre quando um ForeignKeyConstraint é imposto.

SchemaSerializationMode

Indica o modo de serialização de esquema para um DataSettipado.

SchemaType

Especifica como lidar com mapeamentos de esquema existentes ao executar uma operação de FillSchema(DataSet, SchemaType).

SerializationFormat

Determina o formato de serialização de um DataSet.

SqlDbType

Especifica o tipo de dados específico do SQL Server de um campo, propriedade, para uso em um SqlParameter.

StatementType

Especifica o tipo de consulta SQL a ser usada pela classe OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgsou SqlRowUpdatingEventArgs.

UpdateRowSource

Especifica como os resultados do comando de consulta são aplicados à linha que está sendo atualizada.

UpdateStatus

Especifica a ação a ser tomada em relação às linhas atuais e restantes durante um Update(DataSet).

XmlReadMode

Especifica como ler dados XML e um esquema relacional em um DataSet.

XmlWriteMode

Especifica como gravar dados XML e um esquema relacional de um DataSet.

Delegados

Nome Description
DataColumnChangeEventHandler

Representa o método que manipulará o ColumnChanging evento.

DataRowChangeEventHandler

Representa o método que manipulará o RowChanging, RowChangede RowDeletingRowDeleted os eventos de um DataTable.

DataTableClearEventHandler

Representa o método que manipula o Clear() método.

DataTableNewRowEventHandler

Representa o método que manipula o NewRow() método.

FillErrorEventHandler

Representa o método que manipulará o FillError evento.

MergeFailedEventHandler

Representa o método que manipulará o MergeFailed evento.

StateChangeEventHandler

Representa o método que manipulará o StateChange evento.

StatementCompletedEventHandler

O tipo delegado para os manipuladores de eventos do StatementCompleted evento.

Comentários

Em um cenário desconectado, como a Internet, ADO.NET fornece as ferramentas para solicitar, atualizar e reconciliar dados em vários sistemas de camadas. A arquitetura ADO.NET também é implementada em aplicativos cliente, como Windows Forms ou páginas HTML criadas por ASP.NET.

A peça central da arquitetura ADO.NET é a DataSet classe. Cada DataSet um pode conter vários DataTable objetos, com cada DataTable um contendo dados de uma única fonte de dados, como o SQL Server.

Cada DataTable um contém uma DataColumnCollectioncoleção de DataColumn objetos que determina o esquema de cada DataTable. A DataType propriedade determina o tipo de dados mantidos pelo DataColumn. As ReadOnly propriedades e as AllowDBNull propriedades permitem garantir ainda mais a integridade dos dados. A Expression propriedade permite construir colunas calculadas.

Se um DataTable participar de uma relação pai/filho com outro DataTable, a relação será construída adicionando um DataRelation ao DataRelationCollection de um DataSet objeto. Quando essa relação é adicionada, um UniqueConstraint e um ForeignKeyConstraint são criados automaticamente, dependendo das configurações de parâmetro do construtor. As UniqueConstraint garantias de que os valores contidos em uma coluna são exclusivos. Determina ForeignKeyConstraint qual ação ocorrerá com a linha ou coluna filho quando um valor de chave primária for alterado ou excluído.

Usando o System.Data.SqlClient namespace (provedor de dados do the.NET Framework para SQL Server), o System.Data.Odbc namespace (provedor de dados do the.NET Framework para ODBC), o System.Data.OleDb namespace (provedor de dados do the.NET Framework para OLE DB) ou o System.Data.OracleClient namespace (provedor de dados do .NET Framework para Oracle), você pode acessar uma fonte de dados para usar junto com um DataSet. Each.NET provedor de dados do Framework tem um DataAdapter correspondente que você usa como uma ponte entre uma fonte de dados e uma DataSet.