System.Data Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет доступ к классам, представляющим архитектуру ADO.NET. ADO.NET позволяет создавать компоненты, эффективно управляющие данными из нескольких источников данных.
Классы
Constraint |
Представляет ограничение, которое может быть применено к одному или более объектам DataColumn. |
ConstraintCollection |
Представляет коллекцию ограничений для DataTable. |
ConstraintException |
Представляет исключение, возникающее при попытке выполнения действия, нарушающего ограничение. |
DataColumn |
Представляет схему столбца в DataTable. |
DataColumnChangeEventArgs |
Предоставляет данные для события ColumnChanging. |
DataColumnCollection |
Представляет коллекцию объектов DataColumn для DataTable. |
DataException |
Представляет исключение, которое выдается при создании ошибок с помощью компонента ADO.NET. |
DataReaderExtensions |
Предоставляет методы расширения для DbDataReader. |
DataRelation |
Представляет отношение "родительский-дочерний объект" между двумя объектами DataTable. |
DataRelationCollection |
Представляет коллекцию объектов DataRelation для DataSet. |
DataRow |
Представляет строку данных в DataTable. |
DataRowBuilder |
Тип |
DataRowChangeEventArgs |
Предоставляет данные для событий RowChanged, RowChanging, OnRowDeleting(DataRowChangeEventArgs) и OnRowDeleted(DataRowChangeEventArgs). |
DataRowCollection |
Представляет коллекцию строк для объекта DataTable. |
DataRowComparer |
Возвращает одноэлементный экземпляр класса DataRowComparer<TRow>. |
DataRowComparer<TRow> |
Сравнивает два объекта DataRow на эквивалентность путем использования сравнения на основе значений. |
DataRowExtensions |
Определяет методы расширения для класса DataRow. Этот класс является статическим. |
DataRowView |
Представляет настроенное представление DataRow. |
DataSet |
Представляет кэш в памяти для данных. |
DataSetSchemaImporterExtension |
Данный член предназначен для поддержки платформы .NET Framework и не должен вызываться напрямую из кода приложения. |
DataSysDescriptionAttribute |
Помечает свойство, событие или расширитель с описанием. Это описание может быть отображено визуальным конструктором при обновлении элемента. |
DataTable |
Представляет одну таблицу данных в памяти. |
DataTableClearEventArgs |
Предоставляет данные для метода Clear(). |
DataTableCollection |
Представляет коллекцию таблиц для DataSet. |
DataTableExtensions |
Определяет методы расширения для класса DataTable. DataTableExtensions является статическим классом. |
DataTableNewRowEventArgs |
Предоставляет данные для метода NewRow(). |
DataTableReader |
Объект DataTableReader получает содержимое одного или нескольких объектов DataTable в виде одного или нескольких однопроходных результирующих наборов, доступных только для чтения. |
DataView |
Представляет допускающее привязку данных, настраиваемое представление DataTable для сортировки, фильтрации, поиска, изменения и навигации. DataView не сохраняет данные, а представляет связанное представление соответствующего DataTable. Изменения данных DataView повлияют на DataTable. Изменения данных DataTable повлияют на все связанные с ним DataView. |
DataViewManager |
Содержит значение по умолчанию DataViewSettingCollection для каждого DataTable в DataSet. |
DataViewSetting |
Представляет параметры по умолчанию для свойств ApplyDefaultSort, DataViewManager, RowFilter, RowStateFilter, Sort и Table для объекта DataView, созданного из DataViewManager. |
DataViewSettingCollection |
Содержит доступную только для чтения коллекцию объектов DataViewSetting для каждого объекта DataTable в DataSet. |
DBConcurrencyException |
Исключение, которое вызывается объектом DataAdapter во время выполнения операции вставки, обновления или удаления, не затронувшей ни одной строки. |
DeletedRowInaccessibleException |
Представляет исключение, которое выдается при попытке выполнить действие с удаленным объектом DataRow. |
DuplicateNameException |
Представляет исключение, которое выдается, если при добавлении строк в объект, относящийся к DataSet, нарушается уникальность имен объектов базы данных. |
EntityCommandCompilationException |
Представляет ошибки, которые возникают во время компиляции команды, если не удается сформировать дерево команд, представляющее текст команды. |
EntityCommandExecutionException |
Представляет ошибки, возникающие, когда поставщик базового хранилища не может выполнить заданную команду. Это исключение, как правило, зависит от поставщика. |
EntityException |
Представляет связанные с платформой Entity Framework ошибки, возникающие в пространстве имен |
EntityKey |
Предоставляет устойчивую ссылку на объект, являющийся экземпляром типа сущности. |
EntityKeyMember |
Представляет имя ключа и значение, которое является частью ключа EntityKey. |
EntitySqlException |
Представляет ошибки, возникающие при синтаксическом анализе текста команды на языке Entity SQL. Это исключение возникает при нарушении синтаксических и семантических правил. |
EnumerableRowCollection |
Представляет коллекцию объектов DataRow, возвращаемых из запроса LINQ to DataSet. Этот API поддерживает инфраструктуру .NET и не предназначен для использования непосредственно в коде. |
EnumerableRowCollection<TRow> |
Представляет коллекцию объектов DataRow, возвращаемых из запроса. |
EnumerableRowCollectionExtensions |
Содержит методы расширений для классов коллекции строк данных. |
EvaluateException |
Представляет исключение, которое выдается, когда невозможно найти значение свойства Expression класса DataColumn. |
FillErrorEventArgs |
Предоставляет данные для события FillError объекта DbDataAdapter. |
ForeignKeyConstraint |
Представляет ограничение, установленное для набора столбцов в отношении "первичный ключ/внешний ключ", на действия, выполняемые при удалении или обновлении значения или строки. |
InRowChangingEventException |
Представляет исключение, которое выдается при вызове метода EndEdit() в событии RowChanging. |
InternalDataCollectionBase |
Предоставляет базовую функциональность для создания коллекций. |
InvalidCommandTreeException |
Исключение, указывающее на недопустимость дерева команд. В настоящее время это исключение не произошло в Entity Framework. |
InvalidConstraintException |
Представляет исключение, возникающее при неправильной попытке создания отношения или доступа к нему. |
InvalidExpressionException |
Представляет собой исключение, возникающее при попытке добавления столбца DataColumn, содержащего недопустимое выражение Expression, к коллекции DataColumnCollection. |
MappingException |
Исключение, возникающее при сбое запросов связанной службы сопоставления. |
MergeFailedEventArgs |
Происходит, если целевой и исходный объекты |
MetadataException |
Исключение, возникающее при сбое запросов метаданных связанной службы. |
MissingPrimaryKeyException |
Представляет собой исключение, выдаваемое при попытке доступа к строке таблицы, не имеющей первичного ключа. |
NoNullAllowedException |
Представляет исключение, которое создается при попытке вставить значение NULL в столбец, где AllowDBNull имеет значение |
ObjectNotFoundException |
Исключение, возникающее при отсутствии объекта. |
OperationAbortedException |
Это исключение вызывается при прерывании текущей операции пользователем. |
OptimisticConcurrencyException |
Исключение, возникающее при нарушении оптимистичного параллелизма. |
OrderedEnumerableRowCollection<TRow> |
Представляет упорядоченную коллекцию объектов DataRow, возвращенных запросом. |
PropertyCollection |
Представляет коллекцию свойств, которые можно добавить в объекты DataColumn, DataSet или DataTable. |
PropertyConstraintException |
Класс исключений ограничений свойства. Обратите внимание, что этот класс имеет состояние, поэтому если изменить даже его интервалы, это может быть критическое изменение. |
ProviderIncompatibleException |
Исключение, возникающее при несовместимости базового поставщика данных с платформой Entity Framework. |
ReadOnlyException |
Представляет исключение, которое выдается при попытке изменить значение столбца, доступное только для чтения. |
RowNotInTableException |
Представляет исключение, которое выдается при попытке выполнить действие с объектом DataRow, который не содержится в объекте DataTable. |
StateChangeEventArgs |
Предоставляет данные для события изменения состояния поставщика данных .NET. |
StatementCompletedEventArgs |
Предоставляет дополнительные сведения для события StatementCompleted. |
StrongTypingException |
Исключение, которое выдается строго типизированным объектом DataSet, когда пользователь получает доступ к значению |
SyntaxErrorException |
Предоставляет исключение, возникающее, когда свойство Expression объекта DataColumn содержит синтаксическую ошибку. |
TypedDataSetGenerator |
Используется для создания строго типизированного объекта DataSet. |
TypedDataSetGeneratorException |
Это исключение создается в случае конфликта имен при создании объекта DataSet со строгой типизацией. |
TypedTableBase<T> |
Этот тип используется как базовый класс для создания объектов с типом DataTable Visual Studio и инструмента .NET Framework XSD.exe; тип не предназначен для непосредственного использования из кода. |
TypedTableBaseExtensions |
Содержит методы расширения для класса TypedTableBase<T>. |
UniqueConstraint |
Предоставляет ограничение на набор столбцов, в которых все значения должны быть уникальными. |
UpdateException |
Исключение, которое выдается в том случае, когда изменения в экземплярах объектов не могут быть сохранены в источнике данных. |
VersionNotFoundException |
Предоставляет исключение, возникающее при попытке возврата версии объекта DataRow, который был удален. |
Интерфейсы
IColumnMapping |
Связывает столбец источника данных со столбцом DataSet. Этот интерфейс реализуется классом DataColumnMapping, который совместно используется поставщиками данных .NET. |
IColumnMappingCollection |
Содержит коллекцию объектов DataColumnMapping. Этот интерфейс реализуется классом DataColumnMappingCollection, который совместно используется поставщиками данных .NET. |
IDataAdapter |
Позволяет объекту реализовать DataAdapter и представляет набор методов и соответствующие свойства, связанные с операциями, для заполнения и обновления объекта DataSet и обновления источника данных. Экземпляры IDbDataAdapter — для источников данных, которые являются или напоминают реляционные базы данных с текстуальными командами (например, Transact-SQL), а экземпляры IDataAdapter могут использовать любой тип источника данных. |
IDataParameter |
Представляет параметр, относящийся к объекту Command, и при необходимости его сопоставление со столбцами DataSet. Реализация осуществляется с помощью поставщиков данных .NET, у которых есть доступ к источникам данных. |
IDataParameterCollection |
Собирает все параметры, относящиеся к объекту Command, и их сопоставления со столбцами DataSet. Реализация осуществляется с помощью поставщиков данных .NET, у которых есть доступ к источникам данных. |
IDataReader |
Предоставляет средства чтения одного или нескольких прямонаправленных потоков наборов результатов, полученных вследствие выполнения команды в источнике данных. Реализацию осуществляют поставщики данных .NET, которые имеют доступ к реляционным базам данных. |
IDataRecord |
Предоставляет доступ к значениям столбцов в каждой строке для |
IDbCommand |
Представляет инструкцию SQL, которая выполняется при подключении к источнику данных и реализуется поставщиками данных .NET, имеющими доступ к реляционным базам данных. |
IDbConnection |
Представляет открытое подключение к источнику данных и реализуется с помощью поставщиков данных .NET, которые имеют доступ к реляционным базам данных. |
IDbDataAdapter |
Представляет набор связанных с командой свойств, которые используются для заполнения DataSet и обновления источника данных. Этот набор реализуется с помощью поставщиков данных .NET, у которых есть доступ к реляционным базам данных. |
IDbDataParameter |
Используется в конструкторах данных Visual Basic .NET для представления параметра в объект Command и при необходимости его сопоставления со столбцами DataSet. |
IDbTransaction |
Представляет транзакцию, выполняемую с источником данных. Реализуется с помощью поставщиков данных .NET, у которых есть доступ к реляционным базам данных. |
IExtendedDataRecord |
Предоставляет доступ к значениям столбцов в каждой строке DbDataRecord для DbDataReader. |
ITableMapping |
Связывает исходную таблицу с таблицей в DataSet и реализуется классом DataTableMapping, который совместно используется поставщиками данных .NET. |
ITableMappingCollection |
Содержит коллекцию объектов TableMapping. Этот интерфейс реализуется классом DataTableMappingCollection, который совместно используется поставщиками данных .NET. |
Перечисления
AcceptRejectRule |
Определяет действие, выполняемое, когда метод AcceptChanges() или RejectChanges() вызывается в объекте DataTable с объектом ForeignKeyConstraint. |
CommandBehavior |
Предоставляет описание результатов запроса и его влияние на базу данных. |
CommandType |
Указывает способ интерпретации строки команды. |
ConflictOption |
Указывает, каким образом конфликтующие изменения в источнике данных будут выявляться и разрешаться. |
ConnectionState |
Описывает текущее состояние подключения к источнику данных. |
DataRowAction |
Описывает действие, выполняемое с объектом DataRow. |
DataRowState |
Получает состояние объекта DataRow. |
DataRowVersion |
Описание версии DataRow. |
DataSetDateTime |
Описывает формат сериализации для столбцов DateTime в объекте DataSet. |
DataViewRowState |
Описывает версию данных в объекте DataRow. |
DbType |
Указывает тип данных поля, свойства или объекта |
EntityState |
Состояние объекта сущности. |
IsolationLevel |
Указывает режим блокировки транзакций для подключения. |
KeyRestrictionBehavior |
Определяет список параметров строки подключения, определяемых свойством |
LoadOption |
Управляет применением значений из источника данных в существующих строках при использовании метода Load или Load. |
MappingType |
Указывает на порядок сопоставления DataColumn. |
MissingMappingAction |
Определяет действие, которое выполняется при отсутствии сопоставления в исходной таблице или исходном столбце. |
MissingSchemaAction |
Определяет действие, выполняемое при добавлении данных к DataSet, если необходимые объекты DataTable или DataColumn отсутствуют. |
ParameterDirection |
Указывает тип параметра в запросе к объекту DataSet. |
PropertyAttributes |
Указывает атрибуты свойства. |
Rule |
Указывает действие, которое должно быть выполнено для обеспечения ограничения ForeignKeyConstraint. |
SchemaSerializationMode |
Указывает режим схемы сериализации для типизированного объекта DataSet. |
SchemaType |
Указывает, как будут обрабатываться существующие сопоставления схемы при выполнении операции FillSchema(DataSet, SchemaType). |
SerializationFormat |
Определяет формат сериализации для объекта DataSet. |
SqlDbType |
Указывает относящийся к SQL Server тип данных поля или свойства для использования в SqlParameter. |
StatementType |
Задает тип SQL запроса для использования в классах OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgs или SqlRowUpdatingEventArgs. |
UpdateRowSource |
Задает способ применения результатов команды запроса к обновляемой строке. |
UpdateStatus |
Указывает действия, предпринимаемые в отношении текущей строки и остальных строк во время выполнения метода Update(DataSet). |
XmlReadMode |
Указывает, как считывать XML-данные и реляционную схему в объект DataSet. |
XmlWriteMode |
Указывает, как записывать XML-данные и реляционную схему из объекта DataSet. |
Делегаты
DataColumnChangeEventHandler |
Представляет метод обработки события ColumnChanging. |
DataRowChangeEventHandler |
Представляет метод, обрабатывающий события RowChanging, RowChanged, RowDeleting и RowDeleted объекта DataTable. |
DataTableClearEventHandler |
Представляет метод, обрабатывающий метод Clear(). |
DataTableNewRowEventHandler |
Представляет метод, обрабатывающий метод NewRow(). |
FillErrorEventHandler |
Представляет метод обработки события FillError. |
MergeFailedEventHandler |
Представляет метод обработки события MergeFailed. |
StateChangeEventHandler |
Представляет метод обработки события StateChange. |
StatementCompletedEventHandler |
Тип делегата для обработчиков событий, относящихся к событию StatementCompleted. |
Комментарии
В сценарии отсоединения, например Интернете, ADO.NET предоставляет средства запроса, обновления и согласования данных в многоуровневых системах. Архитектура ADO.NET реализуется также в клиентских приложениях, таких как Windows Forms или страницы HTML, созданные в ASP.NET.
Краеугольным камнем архитектуры ADO.NET является класс DataSet. Каждый DataSet может содержать несколько DataTable объектов, каждый из DataTable содержащих данные из одного источника данных, например SQL Server.
Каждый объект DataTable содержит DataColumnCollection, коллекцию объектов DataColumn, определяющую схему объекта DataTable. Свойство DataType определяет тип данных, содержащихся в DataColumn. Свойства ReadOnly и AllowDBNull позволяют с большей уверенностью гарантировать целостность данных. Свойство Expression дает возможность создавать вычисляемые столбцы.
Если объект DataTable является членом связи «родитель-потомок» с другим объектом DataTable, эта связь строится путем добавления DataRelation к DataRelationCollection объекта DataSet. Когда добавляется такая связь, автоматически создаются ограничения UniqueConstraint и ForeignKeyConstraint в зависимости от значения параметра конструктора. Ограничение UniqueConstraint обеспечивает уникальность значений в столбце. Ограничение ForeignKeyConstraint определяет действие, применяемое к дочерней строке или столбцу при изменении или удалении первичного ключа.
С помощью пространств имен System.Data.SqlClient (поставщик данных платформы .NET Framework для SQL Server), System.Data.Odbc (поставщик данных платформы .NET Framework для ODBC), System.Data.OleDb (поставщик данных платформы .NET Framework для OLE DB) и System.Data.OracleClient (поставщик данных платформы .NET Framework для Oracle) можно получить доступ к источнику данных, который будет использоваться совместно с DataSet. Поставщик данных Each.NET Framework имеет соответствующий DataAdapter , который используется в качестве моста между источником данных и DataSet.