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 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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 à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.