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

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

  • Ссылка

Определение

Пространство имен:
System.Data.EntityClient
Сборка:
System.Data.Entity.dll

Инициализирует новый экземпляр класса EntityConnection.

Перегрузки

EntityConnection()

Инициализирует новый экземпляр класса EntityConnection.
EntityConnection(String)

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

Инициализирует новый экземпляр класса EntityConnection с заданными объектами MetadataWorkspace и DbConnection.

Комментарии

Чтобы избежать случайной синхронизации таких объектов, как System.Data.Common.CommandTrees и ObjectContext с их метаданными, EntityConnection необходимо заблокировать их метаданные. После блокировки метаданных изменения строки подключения не допускаются. Ниже приведены два сценария, в которых метаданные блокируются.

  • Экземпляр EntityConnection создается с помощью конструктора без параметров или конструктора EntityConnection(String) , который принимает строку подключения. В любом случае строка подключения может быть изменена несколько раз перед открытием подключения. Вызывает Open или GetMetadataWorkspace блокирует метаданные.

  • Экземпляр EntityConnection создается с помощью конструктора EntityConnection(MetadataWorkspace, DbConnection) , который принимает MetadataWorkspace и DbConnection. В этом случае метаданные блокируются во время создания. Никакие изменения строки подключения не допускаются.

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

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

EntityConnection()

Инициализирует новый экземпляр класса EntityConnection.

public:
 EntityConnection();
public EntityConnection ();
Public Sub New ()

Комментарии

Чтобы избежать случайной синхронизации таких объектов, как System.Data.Common.CommandTrees и ObjectContext с их метаданными, EntityConnection необходимо заблокировать их метаданные. После блокировки метаданных изменения строки подключения не допускаются. Ниже приведены два сценария, в которых метаданные блокируются.

  • Экземпляр EntityConnection создается с помощью конструктора без параметров или конструктора EntityConnection(String) , который принимает строку подключения. В любом случае строка подключения может быть изменена несколько раз перед открытием подключения. Вызывает Open или GetMetadataWorkspace блокирует метаданные.

  • Экземпляр EntityConnection создается с помощью конструктора EntityConnection(MetadataWorkspace, DbConnection) , который принимает MetadataWorkspace и DbConnection. В этом случае метаданные блокируются во время создания. Никакие изменения строки подключения не допускаются.

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

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

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

EntityConnection(String)

Инициализирует новый экземпляр класса EntityConnection на основании строки подключения.

public:
 EntityConnection(System::String ^ connectionString);
public EntityConnection (string connectionString);
new System.Data.EntityClient.EntityConnection : string -> System.Data.EntityClient.EntityConnection
Public Sub New (connectionString As String)

Параметры

connectionString
String

Строка соединения этого поставщика.

Исключения

ArgumentException

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

Комментарии

Средства модели данных сущности создают именованную строку подключения, которая хранится в файле конфигурации приложения. Эту именованную строку подключения можно указать вместо connectionString параметра при создании экземпляра EntityConnection класса .

Чтобы избежать случайного размещения объектов System.Data.Common.CommandTrees и ObjectContext не синхронизированного с их метаданными, EntityConnection необходимо заблокировать их метаданные. После блокировки метаданных изменения строки подключения не допускаются. Ниже приведены два сценария, в которых метаданные блокируются.

  • Экземпляр EntityConnection создается с помощью конструктора без параметров или с помощью этого конструктора (EntityConnection(String)), который принимает строку подключения. В любом случае строка подключения может быть изменена несколько раз перед открытием подключения. Вызывает Open или GetMetadataWorkspace блокирует метаданные.

  • Экземпляр EntityConnection создается с помощью конструктора EntityConnection(MetadataWorkspace, DbConnection) , который принимает MetadataWorkspace и DbConnection. В этом случае метаданные блокируются во время создания. Никакие изменения строки подключения не допускаются.

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

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

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

EntityConnection(MetadataWorkspace, DbConnection)

Инициализирует новый экземпляр класса EntityConnection с заданными объектами MetadataWorkspace и DbConnection.

public:
 EntityConnection(System::Data::Metadata::Edm::MetadataWorkspace ^ workspace, System::Data::Common::DbConnection ^ connection);
public EntityConnection (System.Data.Metadata.Edm.MetadataWorkspace workspace, System.Data.Common.DbConnection connection);
new System.Data.EntityClient.EntityConnection : System.Data.Metadata.Edm.MetadataWorkspace * System.Data.Common.DbConnection -> System.Data.EntityClient.EntityConnection
Public Sub New (workspace As MetadataWorkspace, connection As DbConnection)

Параметры

workspace
MetadataWorkspace

Рабочая область MetadataWorkspace, которую необходимо связать с подключением EntityConnection.

connection
DbConnection

Подключение к базовому источнику данных для этого объекта EntityConnection.

Исключения

ArgumentNullException

Значение параметра workspace или параметра connection — null.

ArgumentException

В рабочей области отсутствует концептуальная модель.

-или-

В рабочей области отсутствует файл сопоставлений.

-или-

В рабочей области отсутствует модель хранения.

-или-

connection не в закрытом состоянии.

ProviderIncompatibleException

connection не от поставщика совместимой ADO.NET Entity Framework.

Комментарии

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

Чтобы избежать случайной синхронизации таких объектов, как System.Data.Common.CommandTrees и ObjectContext , с их метаданными, EntityConnection необходимо заблокировать свои метаданные. После блокировки метаданных изменения строки подключения не допускаются. Ниже приведены два сценария, в которых метаданные блокируются.

  • Экземпляр EntityConnection создается с помощью конструктора без параметров или конструктора EntityConnection(String) , который принимает строку подключения. В любом случае строка подключения может быть изменена несколько раз перед открытием подключения. Вызывает Open или GetMetadataWorkspace блокирует метаданные.

  • Экземпляр EntityConnection создается с помощью этого конструктора MetadataWorkspace (EntityConnection(MetadataWorkspace, DbConnection)), который принимает и DbConnection. В этом случае метаданные блокируются во время создания. Никакие изменения строки подключения не допускаются.

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

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