System.Data Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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. |
| 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 |
| 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 |
| 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 |
| 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.