Compartilhar via


System.Data Namespace

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

Classes

Constraint

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

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 de ColumnChanging .

DataColumnCollection

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

DataException

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

DataReaderExtensions

Fornece métodos de extensão para DbDataReader.

DataRelation

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

DataRelationCollection

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

DataRow

Representa uma linha de dados em um DataTable.

DataRowBuilder

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

DataRowChangeEventArgs

Fornece dados para os eventos RowChanged, RowChanging, OnRowDeleting(DataRowChangeEventArgs) e OnRowDeleted(DataRowChangeEventArgs).

DataRowCollection

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

DataRowComparer

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

DataRowComparer<TRow>

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

DataRowExtensions

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

DataRowView

Representa uma exibição personalizada de um DataRow.

DataSet

Representa um cache em memória dos dados.

DataSetSchemaImporterExtension

Esse membro oferece suporte à infraestrutura .NET Framework e não se destina à utilização diretamente no seu código.

DataSysDescriptionAttribute

Marca uma propriedade, um evento ou um 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 método Clear().

DataTableCollection

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

DataTableExtensions

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

DataTableNewRowEventArgs

Fornece dados para o método NewRow().

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 personalizada sujeita a limite de dados de um DataTable para classificação, filtragem, pesquisa, edição e navegação. O DataView não armazenam dados, mas representa uma exibição conectada do DataTable correspondente. Alterações aos dados do DataView afetarão o DataTable. Alterações aos dados do DataTable afetarão todos os DataViews associados a ele.

DataViewManager

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

DataViewSetting

Representa as configurações padrão para ApplyDefaultSort, DataViewManager, RowFilter, RowStateFilter, Sort e Table para DataViews criadas de DataViewManager.

DataViewSettingCollection

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

DBConcurrencyException

A exceção lançada pelo DataAdapter durante uma operação de inserção, atualização ou exclusão se o número de linhas afetadas é igual a zero.

DeletedRowInaccessibleException

Representa a exceção gerada quando há uma tentativa de ação em um DataRow que foi excluído.

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 objeto relacionado ao DataSet.

EntityCommandCompilationException

Representa os erros que ocorrem durante a compilação de comando; quando uma árvore de comando não pode ser produzida para representar o texto do comando.

EntityCommandExecutionException

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

EntityException

Representa os erros relacionados à Entity Framework que ocorrem no namespace EntityClient. O EntityException é a classe base para todas as exceções de 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 par de nome e valor de chave que faz parte de um EntityKey.

EntitySqlException

Representa os erros que ocorrem ao analisar o texto do comando Entity SQL. Essa exceção é lançada quando regras sintáticas ou semânticas são violadas.

EnumerableRowCollection

Representa uma coleção de objetos DataRow retornada por uma consulta LINQ to 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 objetos DataRow retornada por uma consulta.

EnumerableRowCollectionExtensions

Contém os métodos de extensão para as classes de coleção de linha de dados.

EvaluateException

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

FillErrorEventArgs

Fornece dados para o evento FillError de um DbDataAdapter.

ForeignKeyConstraint

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

InRowChangingEventException

Representa a exceção gerada ao chamar o método EndEdit() dentro do evento RowChanging.

InternalDataCollectionBase

Fornece a funcionalidade básica para a criação de coleções.

InvalidCommandTreeException

A exceção que é gerada para indicar que uma árvore de comando é inválida. Essa exceção atualmente não é gerada em nenhum lugar no Entity Framework.

InvalidConstraintException

Representa a exceção gerada quando ocorre uma tentativa incorreta de criar ou acessar uma relação.

InvalidExpressionException

Representa a exceção gerada ao tentar adicionar uma DataColumn que contém um Expression inválido a um DataColumnCollection.

MappingException

A exceção que é lançada quando o mapeamento de solicitações de serviço relacionadas falha.

MergeFailedEventArgs

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

MetadataException

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

MissingPrimaryKeyException

Representa a exceção que é lançada ao tentar acessar uma linha em uma tabela que não tem chaves primárias.

NoNullAllowedException

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

ObjectNotFoundException

A exceção que é 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 que é gerada quando ocorre uma violação de simultaneidade otimista.

OrderedEnumerableRowCollection<TRow>

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

PropertyCollection

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

PropertyConstraintException

Classe de exceção de restrição de propriedade. Observe que essa classe tem estado, portanto, se você alterar seus recursos internos, essa poderá ser uma alteração significativa.

ProviderIncompatibleException

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

ReadOnlyException

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

RowNotInTableException

Representa a exceção gerada ao tentar executar uma operação em um 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 evento StatementCompleted.

StrongTypingException

A exceção que é lançada por um DataSet fortemente tipado quando o usuário acessa um valor DBNull.

SyntaxErrorException

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

TypedDataSetGenerator

Usado para criar um DataSet fortemente tipado.

TypedDataSetGeneratorException

A exceção lançada quando um conflito de nome ocorre durante a geração de um DataSet fortemente tipado.

TypedTableBase<T>

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

TypedTableBaseExtensions

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

UniqueConstraint

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

UpdateException

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

VersionNotFoundException

Representa a exceção lançada quando você tenta retornar uma versão de um DataRow que foi excluído.

Interfaces

IColumnMapping

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

IColumnMappingCollection

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

IDataAdapter

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

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

IDataParameter

Representa um parâmetro a um objeto de Comando e, como opção, seus mapeamentos para colunas DataSet e é implementado por provedores de dados .NET que acessam as fontes de dados.

IDataParameterCollection

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

IDataReader

Fornece um meio de ler um ou mais fluxos somente encaminhamento de conjuntos de resultados obtidos com a execução de 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 DataReader e é implementado por provedores de dados .NET que acessam bancos de dados relacionais.

IDbCommand

Representa uma instrução SQL que é executada enquanto está conectada a uma fonte de dados e que é 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 ao comando que são usadas para preencher o DataSet e atualizar uma fonte de dados, o qual é implementado por provedores de dados .NET que acessam bancos de dados relacionais.

IDbDataParameter

Usada pelos Designers de dados do Visual Basic .NET para representar um parâmetro para um objeto de comando e, opcionalmente, seu mapeamento para colunas DataSet.

IDbTransaction

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

IExtendedDataRecord

Fornece acesso para os valores de coluna em cada linha de um DbDataRecord para um DbDataReader.

ITableMapping

Associa uma tabela de origem a uma tabela em um DataSet e é implementado pela classe DataTableMapping, que é usada em comum por provedores de dados .NET.

ITableMappingCollection

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

Enumerações

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 sobre o 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 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 são permitidos.

LoadOption

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

MappingType

Especifica como uma DataColumn é mapeada.

MissingMappingAction

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

MissingSchemaAction

Especifica a ação a ser tomada 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 em relação 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 DataSet tipado.

SchemaType

Especifica como tratar os mapeamentos de esquema existentes ao realizar uma operação FillSchema(DataSet, SchemaType).

SerializationFormat

Determina o formato de serialização para 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 usado pela classe OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgs ou 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 adotada com relação à linha atual e às 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

DataColumnChangeEventHandler

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

DataRowChangeEventHandler

Representa o método que manipulará os eventos RowChanging, RowChanged, RowDeleting e RowDeleted de um DataTable.

DataTableClearEventHandler

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

DataTableNewRowEventHandler

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

FillErrorEventHandler

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

MergeFailedEventHandler

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

StateChangeEventHandler

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

StatementCompletedEventHandler

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

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 SQL Server.

Cada DataTable contém uma DataColumnCollection--uma coleçã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 AllowDBNull 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. O ForeignKeyConstraint determina qual ação acontecerá 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 (o provedor de dados .NET Framework para Oracle), você pode acessar uma fonte de dados para usar junto com um DataSet. Each.NET framework provedor de dados tem um DataAdapter correspondente que você usa como uma ponte entre uma fonte de dados e um DataSet.