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


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(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать 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)

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

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