EntityConnection Clase

Definición

Espacio de nombres:

System.Data.EntityClient

Ensamblado:

System.Data.Entity.dll

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

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

Herencia

Object

MarshalByRefObject

Component

DbConnection

EntityConnection

Comentarios

Para evitar que los objetos se coloquen accidentalmente como System.Data.Common.CommandTrees y ObjectContext no se sincronicen con sus metadatos, EntityConnection deben bloquear sus metadatos. No se permiten cambios en el cadena de conexión una vez bloqueados los metadatos. A continuación se muestran dos escenarios en los que los metadatos están bloqueados:

• La instancia se construye a través del constructor sin parámetros o mediante el constructor /> de OpenGetMetadataWorkspace bloquear los metadatos.

• La EntityConnection instancia se construye a través del EntityConnection(MetadataWorkspace, DbConnection) constructor , que acepta y MetadataWorkspace .DbConnection En este caso, los metadatos se bloquean en tiempo de construcción. Nunca se permiten cambios en el cadena de conexión.

Cuando se cargan los metadatos, comprueba EntityConnection 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.

Constructores

Nombre	Description
EntityConnection()	Inicializa una nueva instancia de la clase EntityConnection.
EntityConnection(MetadataWorkspace, DbConnection)	Inicializa una nueva instancia de la EntityConnection clase con un especificado MetadataWorkspace y DbConnection.
EntityConnection(String)	Inicializa una nueva instancia de la clase EntityConnection, en función del cadena de conexión.

Propiedades

Nombre	Description
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
ConnectionString	Obtiene o establece el EntityConnection cadena de conexión.
ConnectionTimeout	Obtiene el número de segundos que se deben esperar al intentar establecer una conexión antes de finalizar el intento y generar un error.
Container	Obtiene el IContainer objeto que contiene el Componentobjeto . (Heredado de Component)
Database	Obtiene el nombre de la base de datos actual o la base de datos que se usará después de abrir una conexión.
DataSource	Obtiene el nombre o la dirección de red del origen de datos al que se va a conectar.
DbProviderFactory	Obtiene para DbProviderFactory este DbConnectionobjeto . (Heredado de DbConnection)
DesignMode	Obtiene un valor que indica si Component el objeto está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos que están asociados a este Componentobjeto . (Heredado de Component)
ServerVersion	Obtiene una cadena que contiene la versión del origen de datos al que está conectado el cliente.
Site	Obtiene o establece ISite de Component. (Heredado de Component)
State	Obtiene la ConnectionState propiedad del proveedor subyacente si EntityConnection está abierto. De lo contrario, devuelve Closed.
StoreConnection	Proporciona acceso a la conexión del origen de datos subyacente que usa el EntityConnection objeto .

Métodos

Nombre	Description
BeginDbTransaction(IsolationLevel)	Cuando se invalida en una clase derivada, inicia una transacción de base de datos. (Heredado de DbConnection)
BeginTransaction()	Comienza una transacción mediante el proveedor subyacente.
BeginTransaction(IsolationLevel)	Comienza una transacción con el nivel de aislamiento especificado mediante el proveedor subyacente.
ChangeDatabase(String)	No está soportado.
Close()	Cierra la conexión a la base de datos.
CreateCommand()	Crea una nueva instancia de , EntityCommandcon el Connection establecido en .EntityConnection
CreateDbCommand()	Cuando se invalida en una clase derivada, crea y devuelve un DbCommand objeto asociado a la conexión actual. (Heredado de DbConnection)
CreateObjRef(Type)	Crea un objeto que contiene toda la información pertinente necesaria para generar un proxy usado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
EnlistTransaction(Transaction)	Lo inscribe EntityConnection en la transacción especificada.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetMetadataWorkspace()	Devuelve el MetadataWorkspace objeto asociado a este EntityConnectionobjeto .
GetSchema()	Devuelve información de esquema para el origen de datos de este DbConnection. (Heredado de DbConnection)
GetSchema(String, String[])	Devuelve información de esquema para el origen de datos de esta DbConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadenas especificada para los valores de restricción. (Heredado de DbConnection)
GetSchema(String)	Devuelve información de esquema para el origen de datos de este DbConnection utilizando la cadena especificada para el nombre del esquema. (Heredado de DbConnection)
GetService(Type)	Devuelve un objeto que representa un servicio proporcionado por Component o por su Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Genera el evento StateChange. (Heredado de DbConnection)
Open()	Establece una conexión con el origen de datos llamando al método del proveedor de Open datos subyacente.
OpenAsync()	Una versión asincrónica de , que abre una conexión de base de Open()datos con la configuración especificada por .ConnectionString Este método invoca el método OpenAsync(CancellationToken) virtual con CancellationToken.None. (Heredado de DbConnection)
OpenAsync(CancellationToken)	Esta es la versión asincrónica de Open(). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el token de cancelación. La implementación predeterminada invoca la llamada sincrónica Open() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationToken ya cancelada. Las excepciones producidas por Open se comunicarán a través de la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del DbConnection objeto hasta que se complete la tarea devuelta. (Heredado de DbConnection)
ToString()	Devuelve un String objeto que contiene el nombre de Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

Nombre	Description
Disposed	Se produce cuando el componente se elimina mediante una llamada al Dispose() método . (Heredado de Component)
StateChange	Se produce cuando cambia el estado de la conexión. (Heredado de DbConnection)

Implementaciones de interfaz explícitas

Nombre	Description
IDbConnection.BeginTransaction()	Inicia una transacción de base de datos. (Heredado de DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Comienza una transacción de base de datos con el nivel de aislamiento especificado. (Heredado de DbConnection)
IDbConnection.CreateCommand()	Crea y devuelve un DbCommand objeto asociado a la conexión actual. (Heredado de DbConnection)

Consulte también

• Proveedor EntityClient para Entity Framework
• Cadena de conexión