EntityConnection Construtores

Definição

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Inicializa uma nova instância da classe EntityConnection.

Sobrecargas

EntityConnection()	Inicializa uma nova instância da classe EntityConnection.
EntityConnection(String)	Inicializa uma nova instância da classe EntityConnection com base na cadeia de conexão.
EntityConnection(MetadataWorkspace, DbConnection)	Inicializa uma nova instância da classe EntityConnection com o MetadataWorkspace e o DbConnection especificados.

Comentários

Para evitar inadvertidamente colocar objetos como System.Data.Common.CommandTrees e ObjectContext fora de sincronia com seus metadados, EntityConnection deve bloquear seus metadados. Nenhuma alteração na cadeia de conexão é permitida depois que os metadados são bloqueados. Veja a seguir dois cenários em que os metadados estão bloqueados:

• A EntityConnection instância é construída por meio do construtor sem parâmetros ou por meio do EntityConnection(String) construtor , que aceita uma cadeia de conexão. Em ambos os casos, a cadeia de conexão pode ser alterada várias vezes antes da conexão ser aberta. Chamar Open ou GetMetadataWorkspace bloquear os metadados.

• A EntityConnection instância é construída por meio do EntityConnection(MetadataWorkspace, DbConnection) construtor , que aceita um MetadataWorkspace e um DbConnection. Nesse caso, os metadados são bloqueados no momento da construção. Nenhuma alteração na cadeia de conexão é permitida.

Quando os metadados são carregados, o EntityConnection verifica se o modelo conceitual, o modelo de armazenamento e o arquivo de mapeamento estão todos presentes.

Para obter exemplos de código, consulte Trabalhando com EntityClient.

EntityConnection()

Inicializa uma nova instância da classe EntityConnection.

public:
 EntityConnection();

public EntityConnection ();

Public Sub New ()

Comentários

Para evitar inadvertidamente colocar objetos como System.Data.Common.CommandTrees e ObjectContext fora de sincronia com seus metadados, EntityConnection deve bloquear seus metadados. Nenhuma alteração na cadeia de conexão é permitida depois que os metadados são bloqueados. Veja a seguir dois cenários em que os metadados estão bloqueados:

• A EntityConnection instância é construída por meio do construtor sem parâmetros ou por meio do EntityConnection(String) construtor , que aceita uma cadeia de conexão. Em ambos os casos, a cadeia de conexão pode ser alterada várias vezes antes da conexão ser aberta. Chamar Open ou GetMetadataWorkspace bloquear os metadados.

• A EntityConnection instância é construída por meio do EntityConnection(MetadataWorkspace, DbConnection) construtor , que aceita um MetadataWorkspace e um DbConnection. Nesse caso, os metadados são bloqueados no momento da construção. Nenhuma alteração na cadeia de conexão é permitida.

Quando os metadados são carregados, o EntityConnection verifica se o modelo conceitual, o modelo de armazenamento e o arquivo de mapeamento estão todos presentes.

Para obter exemplos de código, consulte Trabalhando com EntityClient.

EntityConnection(String)

Inicializa uma nova instância da classe EntityConnection com base na cadeia de conexão.

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)

Parâmetros

connectionString

String

A cadeia de conexão específica do provedor.

Exceções

ArgumentException

Uma palavra-chave de cadeia de conexão inválida foi fornecida ou uma palavra-chave de cadeia de conexão obrigatória não foi fornecida.

Comentários

As ferramentas do Modelo de Dados de Entidade geram uma cadeia de conexão nomeada armazenada no arquivo de configuração do aplicativo. Essa cadeia de conexão nomeada pode ser fornecida no lugar do connectionString parâmetro quando você cria uma instância da EntityConnection classe .

Para evitar inadvertidamente colocar objetos System.Data.Common.CommandTrees e ObjectContext fora de sincronia com seus metadados, EntityConnection deve bloquear seus metadados. Nenhuma alteração na cadeia de conexão é permitida depois que os metadados são bloqueados. Veja a seguir dois cenários em que os metadados estão bloqueados:

• A EntityConnection instância é construída por meio do construtor sem parâmetros ou por meio desse construtor (EntityConnection(String)), que aceita uma cadeia de conexão. Em ambos os casos, a cadeia de conexão pode ser alterada várias vezes antes da conexão ser aberta. Chamar Open ou GetMetadataWorkspace bloquear os metadados.

• A EntityConnection instância é construída por meio do EntityConnection(MetadataWorkspace, DbConnection) construtor , que aceita um MetadataWorkspace e um DbConnection. Nesse caso, os metadados são bloqueados no momento da construção. Nenhuma alteração na cadeia de conexão é permitida.

Quando os metadados são carregados, o EntityConnection verifica se o modelo conceitual, o modelo de armazenamento e o arquivo de mapeamento estão todos presentes.

Para obter exemplos de código, consulte Trabalhando com EntityClient.

EntityConnection(MetadataWorkspace, DbConnection)

Inicializa uma nova instância da classe EntityConnection com o MetadataWorkspace e o DbConnection especificados.

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)

Parâmetros

workspace

MetadataWorkspace

O MetadataWorkspace a ser associado a esse EntityConnection.

connection

DbConnection

A conexão da fonte de dados subjacente para esse objeto EntityConnection.

Exceções

ArgumentNullException

O parâmetro workspace ou connection é null.

ArgumentException

O modelo conceitual está ausente do workspace.

- ou -

O arquivo de mapeamento está ausente do workspace.

- ou -

O modelo de armazenamento está ausente do workspace.

- ou -

O connection não está em um estado fechado.

ProviderIncompatibleException

O connection não é de um provedor compatível com o ADO.NET Entity Framework.

Comentários

Esse construtor permite que você crie um EntityConnection de metadados que não seja de um arquivo em um disco ou de um recurso inserido em um assembly.

Para evitar inadvertidamente colocar objetos como System.Data.Common.CommandTrees e ObjectContext fora de sincronia com seus metadados, o EntityConnection deve bloquear seus metadados. Nenhuma alteração na cadeia de conexão é permitida depois que os metadados são bloqueados. Veja a seguir dois cenários em que os metadados estão bloqueados:

• A EntityConnection instância é construída por meio do construtor sem parâmetros ou por meio do EntityConnection(String) construtor , que aceita uma cadeia de conexão. Em ambos os casos, a cadeia de conexão pode ser alterada várias vezes antes da conexão ser aberta. Chamar Open ou GetMetadataWorkspace bloquear os metadados.

• A EntityConnection instância é construída por meio desse construtor (EntityConnection(MetadataWorkspace, DbConnection)), que aceita um MetadataWorkspace e um DbConnection. Nesse caso, os metadados são bloqueados no momento da construção. Nenhuma alteração na cadeia de conexão é permitida.

Quando os metadados são carregados, o EntityConnection verifica se o modelo conceitual, o modelo de armazenamento e o arquivo de mapeamento estão todos presentes.