EntityConnection Constructores

Definición

Espacio de nombres:

System.Data.EntityClient

Ensamblado:

System.Data.Entity.dll

Inicializa una nueva instancia de la clase EntityConnection.

Sobrecargas

EntityConnection()	Inicializa una nueva instancia de la clase EntityConnection.
EntityConnection(String)	Inicializa una nueva instancia de la clase EntityConnection, tomando como base la cadena de conexión.
EntityConnection(MetadataWorkspace, DbConnection)	Inicializa una nueva instancia de la clase EntityConnection con un MetadataWorkspace y una DbConnection especificados.

Comentarios

Para evitar que objetos como System.Data.Common.CommandTrees y ObjectContext dejen de estar sincronizados involuntariamente con sus metadatos, EntityConnection debe bloquear los metadatos. No se permiten cambios en la cadena de conexión una vez bloqueados los metadatos. A continuación se presentan dos escenarios en los que se bloquean los metadatos:

• La EntityConnection instancia se construye a través del constructor sin parámetros o mediante el EntityConnection(String) constructor , que acepta un cadena de conexión. En cualquiera de los casos, la cadena de conexión se puede cambiar varias veces antes de abrirse la conexión. La llamada a los métodos Open o GetMetadataWorkspace bloquea los metadatos.

• La instancia de EntityConnection se crea mediante el constructor EntityConnection(MetadataWorkspace, DbConnection), que acepta MetadataWorkspace y DbConnection. En este caso, los metadatos se bloquean en el momento de la creación. No se permiten en ningún caso cambios en la cadena de conexión.

Cuando se cargan los metadatos, EntityConnection comprueba que el modelo conceptual, el modelo de almacenamiento y el archivo de asignación estén presentes.

Para obtener ejemplos de código, consulte Trabajar con EntityClient.

EntityConnection()

Inicializa una nueva instancia de la clase EntityConnection.

public:
 EntityConnection();

public EntityConnection ();

Public Sub New ()

Comentarios

Para evitar que objetos como System.Data.Common.CommandTrees y ObjectContext dejen de estar sincronizados involuntariamente con sus metadatos, EntityConnection debe bloquear los metadatos. No se permiten cambios en la cadena de conexión una vez bloqueados los metadatos. A continuación se presentan dos escenarios en los que se bloquean los metadatos:

• La EntityConnection instancia se construye a través del constructor sin parámetros o mediante el EntityConnection(String) constructor , que acepta un cadena de conexión. En cualquiera de los casos, la cadena de conexión se puede cambiar varias veces antes de abrirse la conexión. La llamada a los métodos Open o GetMetadataWorkspace bloquea los metadatos.

• La instancia de EntityConnection se crea mediante el constructor EntityConnection(MetadataWorkspace, DbConnection), que acepta MetadataWorkspace y DbConnection. En este caso, los metadatos se bloquean en el momento de la creación. No se permiten en ningún caso cambios en la cadena de conexión.

Cuando se cargan los metadatos, EntityConnection comprueba que el modelo conceptual, el modelo de almacenamiento y el archivo de asignación estén presentes.

Para obtener ejemplos de código, consulte Trabajar con EntityClient.

EntityConnection(String)

Inicializa una nueva instancia de la clase EntityConnection, tomando como base la cadena de conexión.

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

Cadena de conexión específica del proveedor.

Excepciones

ArgumentException

Se ha proporcionado una palabra clave de la cadena de conexión no válida, o no se ha proporcionado una palabra clave de la cadena de conexión requerida.

Comentarios

Las herramientas de Entity Data Model generan un cadena de conexión con nombre que se almacena en el archivo de configuración de la aplicación. Este cadena de conexión con nombre se puede proporcionar en lugar del connectionString parámetro cuando se crea una instancia de la EntityConnection clase .

Para evitar que objetos como System.Data.Common.CommandTrees y ObjectContext dejen de estar sincronizados involuntariamente con sus metadatos, EntityConnection debe bloquear los metadatos. No se permiten cambios en la cadena de conexión una vez bloqueados los metadatos. A continuación se presentan dos escenarios en los que se bloquean los metadatos:

• La EntityConnection instancia se construye a través del constructor sin parámetros, o a través de este constructor (EntityConnection(String)), que acepta un cadena de conexión. En cualquiera de los casos, la cadena de conexión se puede cambiar varias veces antes de abrirse la conexión. La llamada a los métodos Open o GetMetadataWorkspace bloquea los metadatos.

• La instancia de EntityConnection se crea mediante el constructor EntityConnection(MetadataWorkspace, DbConnection), que acepta MetadataWorkspace y DbConnection. En este caso, los metadatos se bloquean en el momento de la creación. No se permiten en ningún caso cambios en la cadena de conexión.

Cuando se cargan los metadatos, EntityConnection comprueba que el modelo conceptual, el modelo de almacenamiento y el archivo de asignación estén presentes.

Para obtener ejemplos de código, consulte Trabajar con EntityClient.

EntityConnection(MetadataWorkspace, DbConnection)

Inicializa una nueva instancia de la clase EntityConnection con un MetadataWorkspace y una 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

MetadataWorkspace que se va a asociar a esta EntityConnection.

connection

DbConnection

Conexión de origen de datos subyacente para este objeto EntityConnection.

Excepciones

ArgumentNullException

El parámetro workspace o connection es null.

ArgumentException

Falta el modelo conceptual del área de trabajo.

o bien

Falta el archivo de asignación del área de trabajo.

o bien

Falta el modelo de almacenamiento del área de trabajo.

o bien

connection no está en estado cerrado.

ProviderIncompatibleException

connection no procede de un proveedor compatible con ADO.NET Entity Framework.

Comentarios

Este constructor permite crear una EntityConnection a partir de metadatos no procedentes de un archivo en un disco o de un recurso incrustado en un ensamblado.

Para evitar que objetos como System.Data.Common.CommandTrees y ObjectContext dejen de estar sincronizados involuntariamente con sus metadatos, EntityConnection debe bloquear los metadatos. No se permiten cambios en la cadena de conexión una vez bloqueados los metadatos. A continuación se presentan dos escenarios en los que se bloquean los metadatos:

• La EntityConnection instancia se construye a través del constructor sin parámetros o mediante el EntityConnection(String) constructor , que acepta un cadena de conexión. En cualquiera de los casos, la cadena de conexión se puede cambiar varias veces antes de abrirse la conexión. La llamada a los métodos Open o GetMetadataWorkspace bloquea los metadatos.

• La instancia de EntityConnection se crea mediante este constructor (EntityConnection(MetadataWorkspace, DbConnection)), que acepta MetadataWorkspace y DbConnection. En este caso, los metadatos se bloquean en el momento de la creación. No se permiten en ningún caso cambios en la cadena de conexión.

Cuando se cargan los metadatos, EntityConnection comprueba que el modelo conceptual, el modelo de almacenamiento y el archivo de asignación estén presentes.