System.Data Namespace
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.
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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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.