System.Data Espaço de Nomes

Fornece acesso a classes que representam a arquitetura ADO.NET. O ADO.NET permite-lhe construir componentes que gerem dados de forma eficiente de múltiplas fontes de dados.

Classes

Name Description
Constraint

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

ConstraintCollection

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

ConstraintException

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

DataColumn

Representa o esquema de uma coluna num DataTable.

DataColumnChangeEventArgs

Fornece dados para o ColumnChanging evento.

DataColumnCollection

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

DataException

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

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 este DataSet.

DataRow

Representa uma linha de dados num DataTable.

DataRowBuilder

O tipo DataRowBuilder suporta a infraestrutura .NET e não é destinado a ser usado diretamente a partir do seu código.

DataRowChangeEventArgs

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

DataRowCollection

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

DataRowComparer

Devolve uma instância única da DataRowComparer<TRow> classe.

DataRowComparer<TRow>

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

DataRowExtensions

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

DataRowView

Representa uma vista personalizada de um DataRow.

DataSet

Representa uma cache de dados em memória.

DataSetSchemaImporterExtension

Este membro suporta a infraestrutura do .NET Framework e não é destinado a ser usado diretamente a partir do seu código.

DataSysDescriptionAttribute

Marca uma propriedade, evento ou extensor com uma descrição. Os designers visuais podem mostrar esta descrição ao referenciarem o membro.

DataTable

Representa uma tabela de dados em 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 da 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 de leitura e encaminhamento apenas.

DataView

Representa uma vista personalizada e databindable para DataTable ordenação, filtragem, pesquisa, edição e navegação. O DataView não armazena dados, mas representa uma vista conexa do seu correspondente DataTable. Alterações aos DataViewdados de s afetarão o DataTable. Alterações aos DataTabledados de s afetarão todos DataViewos s associados a eles.

DataViewManager

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

DataViewSetting

Representa as definições predefinidas para ApplyDefaultSort, DataViewManager, RowFilter, RowStateFilter, Sort, e Table para DataViews criadas a partir do DataViewManager.

DataViewSettingCollection

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

DBConcurrencyException

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

DeletedRowInaccessibleException

Representa a exceção que é lançada quando uma ação é tentada em um DataRow que foi eliminada.

DuplicateNameException

Representa a exceção que é lançada quando um nome duplicado de objeto de base de dados é encontrado durante uma operação de adição num DataSet objeto -related.

EntityCommandCompilationException

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

EntityCommandExecutionException

Representa erros que ocorrem quando o fornecedor de armazenamento subjacente não conseguiu executar o comando especificado. Esta exceção normalmente envolve uma exceção específica do fornecedor.

EntityException

Representa erros relacionados com o Entity Framework que ocorrem no EntityClient namespace. A EntityException é a classe base para todas as exceções do Entity Framework lançadas pelo EntityClient.

EntityKey

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

EntityKeyMember

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

EntitySqlException

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

EnumerableRowCollection

Representa uma coleção de DataRow objetos devolvidos de uma consulta LINQ para DataSet. Esta API suporta a infraestrutura .NET e não foi concebida para ser usada diretamente a partir do seu código.

EnumerableRowCollection<TRow>

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

EnumerableRowCollectionExtensions

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

EvaluateException

Representa a exceção que é lançada quando a Expression propriedade de a 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 a um conjunto de colunas numa relação chave primária/chave estrangeira quando um valor ou linha é eliminado ou atualizado.

InRowChangingEventException

Representa a exceção que é lançada quando chamas o EndEdit() método dentro do RowChanging evento.

InternalDataCollectionBase

Fornece a funcionalidade base para criar coleções.

InvalidCommandTreeException

A exceção que é lançada para indicar que uma árvore de comandos é inválida. Esta exceção atualmente não é incluída em lado nenhum do Entity Framework.

InvalidConstraintException

Representa a exceção que é lançada quando se tenta criar ou aceder incorretamente a uma relação.

InvalidExpressionException

Representa a exceção que é lançada quando se tenta adicionar um DataColumn que contém um inválido Expression a um DataColumnCollection.

MappingException

A exceção que é lançada quando os pedidos de serviço relacionados com o mapeamento falham.

MergeFailedEventArgs

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

MetadataException

A exceção que é lançada quando os pedidos de serviço relacionados com metadados falham.

MissingPrimaryKeyException

Representa a exceção que é lançada quando tentas aceder a uma linha numa tabela que não tem chave primária.

NoNullAllowedException

Representa a exceção que é lançada quando tenta inserir um valor nulo numa coluna onde AllowDBNull é definido como false.

ObjectNotFoundException

A exceção que é lançada quando um objeto não está presente.

OperationAbortedException

Esta exceção é lançada quando uma operação em curso é abortada pelo utilizador.

OptimisticConcurrencyException

A exceção é lançada quando ocorre uma violação de concorrência otimista.

OrderedEnumerableRowCollection<TRow>

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

PropertyCollection

Representa um conjunto de propriedades que podem ser adicionadas a DataColumn, DataSet, ou DataTable.

PropertyConstraintException

Classe de exceção de restrições de propriedade. Nota que esta classe tem estado – por isso, se mudares até os seus internos, pode ser uma alteração decisiva.

ProviderIncompatibleException

A exceção é lançada quando o fornecedor de dados subjacente é incompatível com o Entity Framework.

ReadOnlyException

Representa a exceção que é lançada quando tentas alterar o valor de uma coluna de apenas leitura.

RowNotInTableException

Representa a exceção que é lançada quando se tenta realizar uma operação num DataRow que não pertence a um DataTable.

StateChangeEventArgs

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

StatementCompletedEventArgs

Fornece informações adicionais sobre o StatementCompleted evento.

StrongTypingException

A exceção que é lançada por um fortemente digitado DataSet quando o utilizador acede a um DBNull valor.

SyntaxErrorException

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

TypedDataSetGenerator

Usado para criar um DataSet.

TypedDataSetGeneratorException

A exceção que é lançada quando ocorre um conflito de nomes ao gerar um DataSet.

TypedTableBase<T>

Este tipo é usado como classe base para geração de objetos typed-DataTable pela Visual Studio e pela ferramenta XSD.exe .NET Framework, e não é destinado a ser usado diretamente a partir do seu código.

TypedTableBaseExtensions

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

UniqueConstraint

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

UpdateException

A exceção que é lançada quando as modificações às instâncias do objeto não podem ser persistidas na fonte de dados.

VersionNotFoundException

Representa a exceção que é lançada quando tentas devolver uma versão de a DataRow que foi apagada.

Interfaces

Name Description
IColumnMapping

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

IColumnMappingCollection

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

IDataAdapter

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

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

IDataParameter

Representa um parâmetro para um objeto Command e, opcionalmente, o seu mapeamento para DataSet colunas; e é implementado por fornecedores de dados .NET que acedem às fontes de dados.

IDataParameterCollection

Recolhe todos os parâmetros relevantes para um objeto Command e os seus mapeamentos para colunas DataSet, e é implementado por fornecedores de dados .NET que acedem às fontes de dados.

IDataReader

Fornece um meio de ler um ou mais fluxos apenas diretos de conjuntos de resultados obtidos através da execução de um comando numa fonte de dados, e é implementado por fornecedores de dados .NET que acedem a bases de dados relacionais.

IDataRecord

Fornece acesso aos valores das colunas dentro de cada linha para um DataReader, e é implementado por fornecedores de dados .NET que acedem a bases de dados relacionais.

IDbCommand

Representa uma instrução SQL que é executada enquanto está ligada a uma fonte de dados, e é implementada por fornecedores de dados .NET que acedem a bases de dados relacionais.

IDbConnection

Representa uma ligação aberta a uma fonte de dados e é implementado por fornecedores de dados .NET que acedem a bases de dados relacionais.

IDbDataAdapter

Representa um conjunto de propriedades relacionadas com comandos que são usadas para preencher o DataSet e atualizar uma fonte de dados, sendo implementado por .NET fornecedores de dados que acedem a bases de dados relacionais.

IDbDataParameter

Usado pelos Visual Basic .NET Data Designers para representar um parâmetro a um objeto Command e, opcionalmente, o seu mapeamento para DataSet colunas.

IDbTransaction

Representa uma transação a ser realizada numa fonte de dados e é implementado por fornecedores de dados .NET que acedem a bases de dados relacionais.

IExtendedDataRecord

Fornece acesso aos valores das colunas dentro de cada linha de a DbDataRecord para um DbDataReader.

ITableMapping

Associa uma tabela de origem a uma tabela num DataSet, e é implementada pela classe DataTableMapping, que é usada em comum por .NET fornecedores de dados.

ITableMappingCollection

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

Enumerações

Name Description
AcceptRejectRule

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

CommandBehavior

Fornece uma descrição dos resultados da consulta e do seu efeito na base de dados.

CommandType

Especifica como uma cadeia de comandos é interpretada.

ConflictOption

Especifica como serão detetadas e resolvidas alterações conflitantes à fonte de dados.

ConnectionState

Descreve o estado atual da ligação a uma fonte de dados.

DataRowAction

Descreve uma ação realizada sobre um DataRow.

DataRowState

Obtém o estado de um DataRow objeto.

DataRowVersion

Descreve a versão de um DataRow.

DataSetDateTime

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

DataViewRowState

Descreve a versão dos dados em um DataRow.

DbType

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

EntityState

O estado de um objeto de entidade.

IsolationLevel

Especifica o comportamento de bloqueio de transações para a ligação.

KeyRestrictionBehavior

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

LoadOption

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

MappingType

Especifica como a DataColumn é mapeada.

MissingMappingAction

Determina a ação que ocorre quando falta um mapeamento numa tabela ou coluna fonte.

MissingSchemaAction

Especifica a ação a tomar ao adicionar dados ao DataSet e o requisito DataTable ou DataColumn está em falta.

ParameterDirection

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

PropertyAttributes

Especifica os atributos de uma propriedade.

Rule

Indica a ação que ocorre quando a ForeignKeyConstraint é aplicada.

SchemaSerializationMode

Indica o modo de serialização do esquema para um .DataSet

SchemaType

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

SerializationFormat

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

SqlDbType

Especifica o tipo de dado específico SQL Server de um campo, propriedade, para uso num SqlParameter.

StatementType

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

UpdateRowSource

Especifica como os resultados dos comandos de consulta são aplicados à linha a ser atualizada.

UpdateStatus

Especifica a ação a tomar relativamente às linhas atuais e restantes durante um Update(DataSet).

XmlReadMode

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

XmlWriteMode

Especifica como escrever dados XML e um esquema relacional a partir de um DataSet.

Delegados

Name Description
DataColumnChangeEventHandler

Representa o método que irá gerir o ColumnChanging evento.

DataRowChangeEventHandler

Representa o método que irá tratar dos RowChanging, RowChanged, RowDeleting, e RowDeleted eventos de um DataTable.

DataTableClearEventHandler

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

DataTableNewRowEventHandler

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

FillErrorEventHandler

Representa o método que irá gerir o FillError evento.

MergeFailedEventHandler

Representa o método que irá gerir o MergeFailed evento.

StateChangeEventHandler

Representa o método que irá gerir o StateChange evento.

StatementCompletedEventHandler

O tipo de delegado para os responsáveis pelo StatementCompleted evento.

Observações

Num cenário desconectado como a Internet, o ADO.NET fornece as ferramentas para solicitar, atualizar e reconciliar dados em sistemas de múltiplos níveis. A arquitetura ADO.NET também é implementada em aplicações clientes, como o Windows Forms ou páginas HTML criadas pelo ASP.NET.

A peça central da arquitetura .NET ADO é a classe DataSet. Cada DataSet pode conter múltiplos objetos DataTable, sendo que cada DataTable contém dados de uma única fonte de dados, como SQL Server.

Cada DataTable um 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 detidos pelos DataColumn. As ReadOnly propriedades e AllowDBNull permitem garantir ainda mais a integridade dos dados. A Expression propriedade permite-lhe construir colunas calculadas.

Se a DataTable participa numa relação pai/filho com outro DataTable, a relação é construída adicionando a DataRelation ao DataRelationCollection de um DataSet objeto. Quando tal relação é adicionada, a UniqueConstraint e a ForeignKeyConstraint são ambos criados automaticamente, dependendo das definições de parâmetros para o construtor. As UniqueConstraint garantias de que os valores contidos numa coluna são únicos. Determina ForeignKeyConstraint que ação acontecerá à linha ou coluna filha quando um valor de chave primária é alterado ou eliminado.

Utilizando o espaço de nomes System.Data.SqlClient (the.NET Framework Data Provider para SQL Server), o espaço de nomes System.Data.Odbc (the.NET Framework Data Provider para ODBC), o espaço de nomes System.Data.OleDb (the.NET Framework Data Provider para OLE DB), ou o espaço de nomes System.Data.OracleClient (o .NET Framework Data Provider para Oracle), pode aceder a uma fonte de dados para usar juntamente com um DataSet. Cada fornecedor de dados .NET Framework tem um DataAdapter correspondente que usa como ponte entre uma fonte de dados e um DataSet.