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событий , RowChangingOnRowDeleting(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, RowFilterRowStateFilterSortи Table для DataViews, созданных из объектаDataViewManager. |
| DataViewSettingCollection |
Содержит коллекцию объектов только для чтения для каждой DataViewSettingDataTableDataSetиз них. |
| DBConcurrencyException |
Исключение, которое возникает DataAdapter во время операции вставки, обновления или удаления, если число строк, затронутых равным нулю. |
| DeletedRowInaccessibleException |
Представляет исключение, которое возникает при попытке действия на удаленном DataRow объекте. |
| DuplicateNameException |
Представляет исключение, возникающее при обнаружении повторяющегося имени объекта базы данных во время операции добавления в DataSet объекте -related. |
| 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 |
Представляет исключение, которое возникает при попытке выполнить операцию в ней DataRowDataTable. |
| StateChangeEventArgs |
Предоставляет данные для события изменения состояния поставщика данных .NET. |
| StatementCompletedEventArgs |
Предоставляет дополнительные сведения о событии StatementCompleted . |
| StrongTypingException |
Исключение, которое вызывается строго типизированным DataSet , когда пользователь обращается к значению |
| SyntaxErrorException |
Представляет исключение, которое возникает, когда Expression свойство содержит DataColumn синтаксическую ошибку. |
| TypedDataSetGenerator |
Используется для создания строго типизированного DataSet. |
| TypedDataSetGeneratorException |
Исключение, возникающее при возникновении конфликта имен при создании строго типизированного DataSet. |
| TypedTableBase<T> |
Этот тип используется в качестве базового класса для создания типизированногоDataTable объекта Visual Studio и средства XSD.exe .NET Framework и не предназначен для использования непосредственно из кода. |
| 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 |
Используется конструкторами данных .NET Для Visual Basic для представления параметра объекту Command и, при необходимости, его сопоставление с DataSet столбцами. |
| IDbTransaction |
Представляет транзакцию, выполняемую в источнике данных, и реализуется поставщиками данных .NET, которые обращаются к реляционным базам данных. |
| IExtendedDataRecord |
Предоставляет доступ к значениям столбцов в каждой DbDataRecord строке для DbDataReadera. |
| 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события RowDeletingRowChanged, и 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. AllowDBNull Свойства ReadOnly позволяют гарантировать целостность данных. Свойство Expression позволяет создавать вычисляемые столбцы.
Если элемент DataTable участвует в связи "родительский/дочерний" с другим DataTable, связь создается путем добавления DataRelation объекта в DataRelationCollectionDataSet объект. При добавлении UniqueConstraint такого отношения автоматически создается и то ForeignKeyConstraint , и другое в зависимости от параметров конструктора. Гарантии UniqueConstraint того, что значения, содержащиеся в столбце, уникальны. Определяет ForeignKeyConstraint , какое действие произойдет с дочерней строкой или столбцом при изменении или удалении значения первичного ключа.
System.Data.SqlClient Используя пространство имен (поставщик данных the.NET Framework для SQL Server), System.Data.Odbc пространство имен (поставщик данных платформы the.NET Framework для ODBC), System.Data.OleDb пространство имен (поставщик данных платформы the.NET Framework для OLE DB) или System.Data.OracleClient пространство имен (поставщик данных .NET Framework для Oracle), вы можете получить доступ к источнику данных для совместного использованияDataSet. поставщик данных Each.NET Framework имеет соответствующий объект DataAdapter , используемый в качестве моста между источником данных и источником DataSetданных.