EntityConnection Класс

Ссылка

Определение

Пространство имен:: System.Data.EntityClient

Сборка:: System.Data.Entity.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Содержит ссылку на концептуальную модель и подключение к источнику данных. Этот класс не наследуется.

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

Наследование: Object

MarshalByRefObject

Component

DbConnection
EntityConnection

Чтобы избежать непреднамеренного размещения таких объектов, как 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(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать `cancellationToken`. Реализация по умолчанию вызывает синхронный метод GetSchema() и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный `cancellationToken`. Исключения, создаваемые GetSchema(), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbConnection)
GetSchemaAsync(String, CancellationToken)	Это асинхронная версия метода GetSchema(String). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать `cancellationToken`. Реализация по умолчанию вызывает синхронный метод GetSchema(String) и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный `cancellationToken`. Исключения, создаваемые GetSchema(String), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Это асинхронная версия метода GetSchema(String, String[]). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать `cancellationToken`. Реализация по умолчанию вызывает синхронный метод GetSchema(String, String[]) и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный `cancellationToken`. Исключения, создаваемые GetSchema(String, String[]), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbConnection)
GetService(Type)	Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Вызывает событие StateChange. (Унаследовано от DbConnection)
Open()	Устанавливает подключение к источнику данных посредством вызова метода `Open` базового поставщика данных.
OpenAsync()	Асинхронная версия Open(), которая открывает соединение с базой данных с параметрами, указанными ConnectionString. Этот метод вызывает виртуальный метод OpenAsync(CancellationToken) с CancellationToken.None. (Унаследовано от DbConnection)
OpenAsync(CancellationToken)	Это асинхронная версия метода Open(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать токен отмены. Реализация по умолчанию вызывает синхронный метод Open() и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken. Исключения, создаваемые Open, будут связаны через возвращаемое свойство исключения задачи. Не вызывайте другие методы и свойства объекта `DbConnection` до тех пор, пока возвращаемая задача не будет завершена. (Унаследовано от DbConnection)
ToString()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)

События

Disposed	Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)
StateChange	Возникает при изменении состояния подключения. (Унаследовано от DbConnection)

Явные реализации интерфейса

IDbConnection.BeginTransaction()	Начинает транзакцию базы данных. (Унаследовано от DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Начинает транзакцию базы данных с указанным уровнем изоляции. (Унаследовано от DbConnection)
IDbConnection.CreateCommand()	Создает и возвращает объект DbCommand, связанный с текущим подключением. (Унаследовано от DbConnection)

Применяется к

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