Поделиться через


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

Тип DataRowBuilder служит для поддержки инфраструктуры .NET и не предназначен для использования непосредственно в коде.

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 ошибки, возникающие в пространстве имен EntityClient. EntityException является базовым классом для всех исключений Entity Framework, которые были вызваны EntityClient.

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

Происходит, если целевой и исходный объекты DataRow имеют одинаковое значение первичного ключа и если свойство EnforceConstraints имеет значение true.

MetadataException

Исключение, возникающее при сбое запросов метаданных связанной службы.

MissingPrimaryKeyException

Представляет собой исключение, выдаваемое при попытке доступа к строке таблицы, не имеющей первичного ключа.

NoNullAllowedException

Представляет исключение, которое создается при попытке вставить значение NULL в столбец, где AllowDBNull имеет значение false.

ObjectNotFoundException

Исключение, возникающее при отсутствии объекта.

OperationAbortedException

Это исключение вызывается при прерывании текущей операции пользователем.

OptimisticConcurrencyException

Исключение, возникающее при нарушении оптимистичного параллелизма.

OrderedEnumerableRowCollection<TRow>

Представляет упорядоченную коллекцию объектов DataRow, возвращенных запросом.

PropertyCollection

Представляет коллекцию свойств, которые можно добавить в объекты DataColumn, DataSet или DataTable.

PropertyConstraintException

Класс исключений ограничений свойства. Обратите внимание, что этот класс имеет состояние, поэтому если изменить даже его интервалы, это может быть критическое изменение.

ProviderIncompatibleException

Исключение, возникающее при несовместимости базового поставщика данных с платформой Entity Framework.

ReadOnlyException

Представляет исключение, которое выдается при попытке изменить значение столбца, доступное только для чтения.

RowNotInTableException

Представляет исключение, которое выдается при попытке выполнить действие с объектом DataRow, который не содержится в объекте DataTable.

StateChangeEventArgs

Предоставляет данные для события изменения состояния поставщика данных .NET.

StatementCompletedEventArgs

Предоставляет дополнительные сведения для события StatementCompleted.

StrongTypingException

Исключение, которое выдается строго типизированным объектом DataSet, когда пользователь получает доступ к значению DBNull.

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

Предоставляет доступ к значениям столбцов в каждой строке для DataReader. Реализация осуществляется с помощью поставщиков данных .NET, у которых есть доступ к реляционным базам данных.

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

Указывает тип данных поля, свойства или объекта Parameter поставщика данных .NET.

EntityState

Состояние объекта сущности.

IsolationLevel

Указывает режим блокировки транзакций для подключения.

KeyRestrictionBehavior

Определяет список параметров строки подключения, определяемых свойством KeyRestrictions, которые могут быть разрешены или запрещены.

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.