EntityConnection Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Содержит ссылку на концептуальную модель и подключение к источнику данных. Этот класс не наследуется.
public ref class EntityConnection sealed : System::Data::Common::DbConnection
public sealed class EntityConnection : System.Data.Common.DbConnection
type EntityConnection = class
inherit DbConnection
Public NotInheritable Class EntityConnection
Inherits DbConnection
- Наследование
Комментарии
Чтобы избежать непреднамеренного размещения таких объектов, как System.Data.Common.CommandTrees и ObjectContext не синхронизированных с их метаданными, EntityConnection необходимо заблокировать их метаданные. После блокировки метаданных изменения строки подключения не допускаются. Ниже приведены два сценария, в которых метаданные блокируются.
Экземпляр EntityConnection создается с помощью конструктора без параметров или конструктора EntityConnection(String) , который принимает строку подключения. В любом случае строка подключения может быть изменена несколько раз перед открытием подключения. Вызывает Open или GetMetadataWorkspace блокирует метаданные.
Экземпляр EntityConnection создается с помощью конструктора EntityConnection(MetadataWorkspace, DbConnection) , который принимает MetadataWorkspace и DbConnection. В этом случае метаданные блокируются во время создания. Никакие изменения строки подключения не допускаются.
При загрузке метаданных объект проверяет наличие EntityConnection концептуальной модели, модели хранения и файла сопоставления.
Примеры кода см. в разделе Работа с EntityClient.
Конструкторы
| EntityConnection() |
Инициализирует новый экземпляр класса EntityConnection. |
| EntityConnection(MetadataWorkspace, DbConnection) |
Инициализирует новый экземпляр класса EntityConnection с заданными объектами MetadataWorkspace и DbConnection. |
| EntityConnection(String) |
Инициализирует новый экземпляр класса EntityConnection на основании строки подключения. |
Свойства
| CanCreateBatch |
Возвращает значение, определяющее, поддерживает ли экземпляр DbConnection класс DbBatch. (Унаследовано от DbConnection) |
| CanRaiseEvents |
Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component) |
| ConnectionString |
Возвращает или задает строку соединения EntityConnection. |
| ConnectionTimeout |
Получает время ожидания (в секундах) при попытке установления подключения, по истечении которого попытка подключения завершается и создается ошибка. |
| Container |
Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component) |
| Database |
Получает имя текущей базы данных или той базы данных, которая будет использоваться после открытия подключения. |
| DataSource |
Возвращает имя или сетевой адрес источника данных, с которым должно быть установлено соединение. |
| DbProviderFactory |
Получает объект DbProviderFactory для данного элемента DbConnection. (Унаследовано от DbConnection) |
| DesignMode |
Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component) |
| Events |
Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component) |
| ServerVersion |
Получает строку, содержащую версию источника данных, к которому подключается клиент. |
| Site |
Получает или задает ISite объекта Component. (Унаследовано от Component) |
| State |
Возвращает свойство ConnectionState базового поставщика, если соединение EntityConnection открыто. В противном случае возвращается Closed. |
| StoreConnection |
Предоставляет доступ к подключению к базовому источнику данных, которое используется объектом EntityConnection. |
Методы
| BeginDbTransaction(IsolationLevel) |
При переопределении в производном классе запускает транзакцию в базе данных. (Унаследовано от DbConnection) |
| BeginDbTransactionAsync(IsolationLevel, CancellationToken) |
Асинхронно запускает транзакцию в базе данных. (Унаследовано от DbConnection) |
| BeginTransaction() |
Начинает транзакцию посредством базового поставщика. |
| BeginTransaction(IsolationLevel) |
Начинает транзакцию на указанном уровне изоляции посредством базового поставщика. |
| BeginTransactionAsync(CancellationToken) |
Асинхронно начинает транзакцию базы данных. (Унаследовано от DbConnection) |
| BeginTransactionAsync(IsolationLevel, CancellationToken) |
Асинхронно начинает транзакцию базы данных. (Унаследовано от DbConnection) |
| ChangeDatabase(String) |
Не поддерживается. |
| ChangeDatabaseAsync(String, CancellationToken) |
Асинхронно изменяет текущую базу данных для открытого подключения. (Унаследовано от DbConnection) |
| Close() |
Закрывает соединение с базой данных. |
| CloseAsync() |
Асинхронно закрывает подключение к базе данных. (Унаследовано от DbConnection) |
| CreateBatch() |
Возвращает новый экземпляра класса поставщика, реализующий класс DbBatch. (Унаследовано от DbConnection) |
| CreateCommand() |
Создает новый экземпляр EntityCommand, свойство Connection которого установлено в значение EntityConnection. |
| CreateDbBatch() |
При переопределении в производном классе возвращает новый экземпляр класса поставщика, который реализует DbBatch класс . (Унаследовано от DbConnection) |
| CreateDbCommand() |
При переопределении в производном классе создает и возвращает объект DbCommand, связанный с текущим подключением. (Унаследовано от DbConnection) |
| CreateObjRef(Type) |
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Dispose() |
Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от DbConnection) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом DbConnection, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DbConnection) |
| DisposeAsync() |
Асинхронно размещает объект подключения. (Унаследовано от DbConnection) |
| EnlistTransaction(Transaction) |
Прикрепляет данный объект EntityConnection в указанной транзакции. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLifetimeService() |
Устаревшие..
Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject) |
| GetMetadataWorkspace() |
Возвращает рабочую область метаданных MetadataWorkspace, связанную с соединением EntityConnection. |
| GetSchema() |
Возвращает сведения схемы для источника данных этого объекта DbConnection. (Унаследовано от DbConnection) |
| GetSchema(String) |
Возвращает сведения о схеме для источника данных этого объекта DbConnection, используя указанную строку в качестве имени схемы. (Унаследовано от DbConnection) |
| GetSchema(String, String[]) |
Возвращает сведения о схеме для источника данных этого объекта DbConnection, используя указанную строку в качестве имени схемы и указанный массив строк для значений ограничений. (Унаследовано от DbConnection) |
| GetSchemaAsync(CancellationToken) |
Это асинхронная версия метода GetSchema().
Поставщики должны выполнить переопределение с помощью соответствующей реализации.
При необходимости можно учитывать |
| GetSchemaAsync(String, CancellationToken) |
Это асинхронная версия метода GetSchema(String).
Поставщики должны выполнить переопределение с помощью соответствующей реализации.
При необходимости можно учитывать |
| GetSchemaAsync(String, String[], CancellationToken) |
Это асинхронная версия метода GetSchema(String, String[]).
Поставщики должны выполнить переопределение с помощью соответствующей реализации.
При необходимости можно учитывать |
| GetService(Type) |
Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| InitializeLifetimeService() |
Устаревшие..
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MemberwiseClone(Boolean) |
Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject) |
| OnStateChange(StateChangeEventArgs) |
Вызывает событие StateChange. (Унаследовано от DbConnection) |
| Open() |
Устанавливает подключение к источнику данных посредством вызова метода |
| OpenAsync() |
Асинхронная версия Open(), которая открывает соединение с базой данных с параметрами, указанными ConnectionString. Этот метод вызывает виртуальный метод OpenAsync(CancellationToken) с CancellationToken.None. (Унаследовано от DbConnection) |
| OpenAsync(CancellationToken) |
Это асинхронная версия метода Open(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать токен отмены. Реализация по умолчанию вызывает синхронный метод Open() и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken. Исключения, создаваемые Open, будут связаны через возвращаемое свойство исключения задачи. Не вызывайте другие методы и свойства объекта |
| ToString() |
Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component) |
События
| Disposed |
Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component) |
| StateChange |
Возникает при изменении состояния подключения. (Унаследовано от DbConnection) |
Явные реализации интерфейса
| IDbConnection.BeginTransaction() |
Начинает транзакцию базы данных. (Унаследовано от DbConnection) |
| IDbConnection.BeginTransaction(IsolationLevel) |
Начинает транзакцию базы данных с указанным уровнем изоляции. (Унаследовано от DbConnection) |
| IDbConnection.CreateCommand() |
Создает и возвращает объект DbCommand, связанный с текущим подключением. (Унаследовано от DbConnection) |