EntityConnection Clase

Referencia

Definición

Espacio de nombres:: System.Data.EntityClient

Ensamblado:: System.Data.Entity.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Contiene una referencia a un modelo conceptual y una conexión a un 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 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 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 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.

Constructores

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

Propiedades

CanCreateBatch	Obtiene un valor que indica si esta instancia de DbConnection admite la clase DbBatch. (Heredado de DbConnection)
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
ConnectionString	Obtiene o establece la cadena de conexión EntityConnection.
ConnectionTimeout	Obtiene 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.
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
Database	Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar una vez que se abra la conexión.
DataSource	Obtiene el nombre o la dirección de red del origen de datos con el que se va a establecer conexión.
DbProviderFactory	Obtiene el objeto DbProviderFactory para este objeto DbConnection. (Heredado de DbConnection)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (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 propiedad ConnectionState del proveedor subyacente si EntityConnection está abierta. De lo contrario, devuelve Closed.
StoreConnection	Proporciona acceso a la conexión de origen de datos subyacente usada por el objeto EntityConnection.

Métodos

BeginDbTransaction(IsolationLevel)	Cuando se invalida en una clase derivada, inicia una transacción de base de datos. (Heredado de DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Inicia de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
BeginTransaction()	Comienza una transacción utilizando el proveedor subyacente.
BeginTransaction(IsolationLevel)	Comienza una transacción con el nivel de aislamiento especificado utilizando el proveedor subyacente.
BeginTransactionAsync(CancellationToken)	Empieza de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Empieza de forma asincrónica una transacción de base de datos. (Heredado de DbConnection)
ChangeDatabase(String)	No compatible.
ChangeDatabaseAsync(String, CancellationToken)	Cambia de forma asincrónica la base de datos actual de una conexión abierta. (Heredado de DbConnection)
Close()	Cierra la conexión con la base de datos.
CloseAsync()	Cierra de forma asincrónica la conexión con la base de datos. (Heredado de DbConnection)
CreateBatch()	Devuelve una nueva instancia de la clase del proveedor que implementa la clase DbBatch. (Heredado de DbConnection)
CreateCommand()	Crea una instancia nueva de EntityCommand, con la propiedad Connection establecida en EntityConnection.
CreateDbBatch()	Cuando se reemplaza en una clase derivada, devuelve una nueva instancia de la clase del proveedor que implementa la DbBatch clase . (Heredado de DbConnection)
CreateDbCommand()	Cuando se reemplaza en una clase derivada, crea y devuelve un objeto DbCommand asociado a la conexión actual. (Heredado de DbConnection)
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de DbConnection)
Dispose(Boolean)	Libera los recursos no administrados que usa DbConnection y, de forma opcional, libera los recursos administrados. (Heredado de DbConnection)
DisposeAsync()	Desecha de forma asincrónica el objeto de conexión. (Heredado de DbConnection)
EnlistTransaction(Transaction)	Da de alta esta 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 la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Obsoletos. 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 objeto MetadataWorkspace asociado a esta EntityConnection.
GetSchema()	Devuelve información de esquema para el origen de datos de DbConnection. (Heredado de DbConnection)
GetSchema(String)	Devuelve información de esquema para el origen de datos de DbConnection utilizando la cadena especificada para el nombre del esquema. (Heredado de DbConnection)
GetSchema(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. (Heredado de DbConnection)
GetSchemaAsync(CancellationToken)	Esta es una versión asincrónica de GetSchema(). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar `cancellationToken`. La implementación predeterminada invoca la llamada sincrónica a GetSchema() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un `cancellationToken` ya cancelado. Las excepciones producidas por GetSchema() se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbConnection)
GetSchemaAsync(String, CancellationToken)	Esta es la versión asincrónica de GetSchema(String). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar `cancellationToken`. La implementación predeterminada invoca la llamada sincrónica a GetSchema(String) y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un `cancellationToken` ya cancelado. Las excepciones producidas por GetSchema(String) se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Esta es la versión asincrónica de GetSchema(String, String[]). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar `cancellationToken`. La implementación predeterminada invoca la llamada sincrónica a GetSchema(String, String[]) y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un `cancellationToken` ya cancelado. Las excepciones producidas por GetSchema(String, String[]) se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbConnection)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obsoletos. 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 Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (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 `Open` del proveedor de datos subyacente.
OpenAsync()	Una versión asincrónica de Open(), que abre una conexión a bases de datos con los valores especificados por ConnectionString. Este método invoca el método virtual OpenAsync(CancellationToken) con CancellationToken.None. (Heredado de DbConnection)
OpenAsync(CancellationToken)	Esta es la versión asincrónica de Open(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede aceptar opcionalmente. La implementación predeterminada invoca la llamada sincrónica a Open() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por Open se comunicarán mediante la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del objeto `DbConnection` hasta que se haya completado la tarea devuelta. (Heredado de DbConnection)
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

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

Implementaciones de interfaz explícitas

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

Se aplica a

Compartir a través de