Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

EntityConnection (Clase)

Contiene una referencia a un modelo conceptual y una conexión a un origen de datos. Esta clase no puede heredarse.

Espacio de nombres:  System.Data.EntityClient
Ensamblado:  System.Data.Entity (en System.Data.Entity.dll)

public sealed class EntityConnection : DbConnection

El tipo EntityConnection expone los siguientes miembros.

  NombreDescripción
Método públicoEntityConnection()Inicializa una nueva instancia de la clase EntityConnection.
Método públicoEntityConnection(String)Inicializa una nueva instancia de la clase EntityConnection, basándose en la cadena de conexión.
Método públicoEntityConnection(MetadataWorkspace, DbConnection)Inicializa una nueva instancia de la clase EntityConnection con los objetos MetadataWorkspace y DbConnection especificados.
Arriba

  NombreDescripción
Propiedad protegidaCanRaiseEventsObtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad públicaConnectionStringObtiene o establece la cadena de conexión EntityConnection. (Invalida a DbConnection.ConnectionString).
Propiedad públicaConnectionTimeoutObtiene el número de segundos que se debe esperar cuando se intenta establecer una conexión antes de que finalice el intento y se genere un error. (Invalida a DbConnection.ConnectionTimeout).
Propiedad públicaContainerObtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad públicaDatabaseObtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar cuando se abra la conexión. (Invalida a DbConnection.Database).
Propiedad públicaDataSourceObtiene el nombre o la dirección de red del origen de datos con el que se va a conectar. (Invalida a DbConnection.DataSource).
Propiedad protegidaDbProviderFactoryObtiene DbProviderFactory para este DbConnection. (Se hereda de DbConnection).
Propiedad protegidaDesignModeObtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegidaEventsObtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad públicaServerVersionObtiene una cadena que contiene la versión del origen de datos al que está conectado el cliente. (Invalida a DbConnection.ServerVersion).
Propiedad públicaSiteObtiene o establece ISite de Component. (Se hereda de Component).
Propiedad públicaStateObtiene la propiedad ConnectionState del proveedor subyacente si el objeto EntityConnection está abierto. En caso contrario, devuelve Closed. (Invalida a DbConnection.State).
Propiedad públicaStoreConnectionProporciona acceso a la conexión de origen de datos subyacente usada por el objeto EntityConnection.
Arriba

  NombreDescripción
Método protegidoBeginDbTransactionInicia una transacción de base de datos. (Se hereda de DbConnection).
Método públicoBeginTransaction()Comienza una transacción utilizando el proveedor subyacente.
Método públicoBeginTransaction(IsolationLevel)Comienza una transacción con el nivel de aislamiento especificado utilizando el proveedor subyacente.
Método públicoChangeDatabaseNo se admite. (Invalida a DbConnection.ChangeDatabase(String)).
Método públicoCloseCierra la conexión con la base de datos. (Invalida a DbConnection.Close()).
Método públicoCreateCommandCrea una nueva instancia de EntityCommand, con la propiedad Connection establecida en EntityConnection.
Método protegidoCreateDbCommandCrea y devuelve un objeto DbCommand asociado a la conexión actual. (Se hereda de DbConnection).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoDispose()Libera todos los recursos utilizados por el objeto Component. (Se hereda de Component).
Método protegidoDispose(Boolean)Libera los recursos no administrados usados por Component y, opcionalmente, los recursos administrados. (Se hereda de Component).
Método públicoEnlistTransactionDa de alta este objeto EntityConnection en la transacción especificada. (Invalida a DbConnection.EnlistTransaction(Transaction)).
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegidoFinalizeLibera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método públicoGetMetadataWorkspaceDevuelve el objeto MetadataWorkspace asociado a este objeto EntityConnection.
Método públicoGetSchema()Devuelve información de esquema para el origen de datos de DbConnection. (Se hereda de DbConnection).
Método públicoGetSchema(String)Devuelve información de esquema para el origen de datos de DbConnection utilizando la cadena especificada para el nombre del esquema. (Se hereda de DbConnection).
Método públicoGetSchema(String, String[])Devuelve información de esquema para el origen de datos de DbConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadena determinada para los valores de restricción. (Se hereda de DbConnection).
Método protegidoGetServiceDevuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método públicoGetTypeObtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoMemberwiseClone()Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método protegidoOnStateChangeProvoca el evento StateChange. (Se hereda de DbConnection).
Método públicoOpenEstablece una conexión con el origen de datos llamando al método Open del proveedor de datos subyacente. (Invalida a DbConnection.Open()).
Método públicoToStringDevuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista. Este método no debe reemplazarse. (Se hereda de Component).
Arriba

  NombreDescripción
Evento públicoDisposedSe produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Evento públicoStateChangeSe produce cuando cambia el estado del evento. (Se hereda de DbConnection).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoIDbConnection.BeginTransaction()Inicia una transacción de base de datos. (Se hereda de DbConnection).
Implementación explícita de interfacesMétodo privadoIDbConnection.BeginTransaction(IsolationLevel)Inicia una transacción de base de datos con el valor de IsolationLevel especificado. (Se hereda de DbConnection).
Implementación explícita de interfacesMétodo privadoIDbConnection.CreateCommandCrea y devuelve un objeto DbCommand asociado a la conexión actual. (Se hereda de DbConnection).
Arriba

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 instancia de EntityConnection se crea mediante el constructor predeterminado, o mediante el constructor EntityConnection(String), que acepta una 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 [M:System.Data.EntityClient.EntityConnection.Open()] o [M:System.Data.EntityClient.EntityConnection.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, vea Working with EntityClient.

.NET Framework

Compatible con: 4, 3.5 SP1

.NET Framework Client Profile

Compatible con: 4

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Mostrar: