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) , который принимает a MetadataWorkspace и a DbConnection. В этом случае метаданные заблокированы во время построения. Изменения в строка подключения никогда не допускаются.

При загрузке метаданных проверяет наличие EntityConnection концептуальной модели, модели хранения и файла сопоставления.

Примеры кода см. в разделе "Работа с EntityClient".

Конструкторы

Имя	Описание
EntityConnection()	Инициализирует новый экземпляр класса EntityConnection.
EntityConnection(MetadataWorkspace, DbConnection)	Инициализирует новый экземпляр класса EntityConnection с указанным MetadataWorkspace и DbConnection.
EntityConnection(String)	Инициализирует новый экземпляр класса EntityConnection на основе строка подключения.

Свойства

Имя	Описание
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)
BeginTransaction()	Начинает транзакцию с помощью базового поставщика.
BeginTransaction(IsolationLevel)	Начинает транзакцию с указанным уровнем изоляции с помощью базового поставщика.
ChangeDatabase(String)	Не поддерживается.
Close()	Закрывает подключение к базе данных.
CreateCommand()	Создает новый экземпляр объекта EntityCommandс заданным значением ConnectionEntityConnection.
CreateDbCommand()	При переопределении в производном классе создает и возвращает DbCommand объект, связанный с текущим подключением. (Унаследовано от DbConnection)
CreateObjRef(Type)	Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
EnlistTransaction(Transaction)	Перечисляет это EntityConnection в указанную транзакцию.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит в качестве хэш-функции по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetMetadataWorkspace()	Возвращает связанный MetadataWorkspace с этим EntityConnectionобъект.
GetSchema()	Возвращает сведения о схеме для источника данных этого DbConnectionобъекта. (Унаследовано от DbConnection)
GetSchema(String, String[])	Возвращает сведения о схеме для источника данных, DbConnection используя указанную строку для имени схемы и указанный массив строк для значений ограничений. (Унаследовано от DbConnection)
GetSchema(String)	Возвращает сведения о схеме для источника данных, DbConnection используя указанную строку для имени схемы. (Унаследовано от 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() вызов и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу, если передана уже отмененная отменаToken. Исключения, создаваемые Open, будут передаваться через возвращаемое свойство "Исключение задачи". Не вызывайте другие методы и свойства DbConnection объекта до завершения возвращаемой задачи. (Унаследовано от DbConnection)
ToString()	String Возвращает имя, содержащее имя , если таковое Componentимеется. Этот метод не должен быть переопределен. (Унаследовано от Component)

События

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

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

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

См. также раздел

• Поставщик EntityClient для Entity Framework
• Строка подключения