EntityConnection EntityConnection EntityConnection EntityConnection Class

Definición

Contiene una referencia a un modelo conceptual y una conexión a un origen de datos.Contains a reference to a conceptual model and a data source connection. Esta clase no puede heredarse.This class cannot be inherited.

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

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.To avoid inadvertently putting objects such as System.Data.Common.CommandTrees and ObjectContext out of sync with their metadata, EntityConnection must lock its metadata. No se permiten cambios en la cadena de conexión una vez bloqueados los metadatos.No changes to the connection string are allowed after the metadata is locked. A continuación se presentan dos escenarios en los que se bloquean los metadatos:The following are two scenarios in which metadata is locked:

Cuando se cargan los metadatos, EntityConnection comprueba que el modelo conceptual, el modelo de almacenamiento y el archivo de asignación estén presentes.When metadata is loaded, the EntityConnection verifies that the conceptual model, the storage model, and the mapping file are all present.

Para obtener ejemplos de código, vea trabajar con EntityClient.For code examples, see Working with EntityClient.

Constructores

EntityConnection() EntityConnection() EntityConnection() EntityConnection()

Inicializa una nueva instancia de la clase EntityConnection.Initializes a new instance of the EntityConnection class.

EntityConnection(MetadataWorkspace, DbConnection) EntityConnection(MetadataWorkspace, DbConnection) EntityConnection(MetadataWorkspace, DbConnection) EntityConnection(MetadataWorkspace, DbConnection)

Inicializa una nueva instancia de la clase EntityConnection con un MetadataWorkspace y una DbConnection especificados.Initializes a new instance of the EntityConnection class with a specified MetadataWorkspace and DbConnection.

EntityConnection(String) EntityConnection(String) EntityConnection(String) EntityConnection(String)

Inicializa una nueva instancia de la clase EntityConnection, tomando como base la cadena de conexión.Initializes a new instance of the EntityConnection class, based on the connection string.

Propiedades

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

Obtiene o establece la cadena de conexión EntityConnection.Gets or sets the EntityConnection connection string.

ConnectionTimeout ConnectionTimeout ConnectionTimeout 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.Gets the number of seconds to wait when attempting to establish a connection before ending the attempt and generating an error.

Container Container Container Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Database Database Database 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.Gets the name of the current database, or the database that will be used after a connection is opened.

DataSource DataSource DataSource DataSource

Obtiene el nombre o la dirección de red del origen de datos con el que se va a establecer conexión.Gets the name or network address of the data source to connect to.

DbProviderFactory DbProviderFactory DbProviderFactory DbProviderFactory

Obtiene el objeto DbProviderFactory para este objeto DbConnection.Gets the DbProviderFactory for this DbConnection.

(Inherited from DbConnection)
DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ServerVersion ServerVersion ServerVersion ServerVersion

Obtiene una cadena que contiene la versión del origen de datos al que está conectado el cliente.Gets a string that contains the version of the data source to which the client is connected.

Site Site Site Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Obtiene la propiedad ConnectionState del proveedor subyacente si EntityConnection está abierta.Gets the ConnectionState property of the underlying provider if the EntityConnection is open. De lo contrario, devuelve Closed.Otherwise, returns Closed.

StoreConnection StoreConnection StoreConnection StoreConnection

Proporciona acceso a la conexión de origen de datos subyacente usada por el objeto EntityConnection.Provides access to the underlying data source connection that is used by the EntityConnection object.

Métodos

BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel)

Inicia una transacción de base de datos.Starts a database transaction.

(Inherited from DbConnection)
BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

Comienza una transacción utilizando el proveedor subyacente.Begins a transaction by using the underlying provider.

BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel)

Comienza una transacción con el nivel de aislamiento especificado utilizando el proveedor subyacente.Begins a transaction with the specified isolation level by using the underlying provider.

ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

No se admite.Not supported.

Close() Close() Close() Close()

Cierra la conexión con la base de datos.Closes the connection to the database.

CreateCommand() CreateCommand() CreateCommand() CreateCommand()

Crea una instancia nueva de EntityCommand, con la propiedad Connection establecida en EntityConnection.Creates a new instance of an EntityCommand, with the Connection set to this EntityConnection.

CreateDbCommand() CreateDbCommand() CreateDbCommand() CreateDbCommand()

Crea y devuelve un objeto DbCommand asociado a la conexión actual.Creates and returns a DbCommand object associated with the current connection.

(Inherited from DbConnection)
CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose() Inherited from DbConnection
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Inherited from DbConnection
EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

Da de alta esta EntityConnection en la transacción especificada.Enlists this EntityConnection in the specified transaction.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetMetadataWorkspace() GetMetadataWorkspace() GetMetadataWorkspace() GetMetadataWorkspace()

Devuelve el objeto MetadataWorkspace asociado a esta EntityConnection.Returns the MetadataWorkspace associated with this EntityConnection.

GetSchema() GetSchema() GetSchema() GetSchema()

Devuelve información de esquema para el origen de datos de DbConnection.Returns schema information for the data source of this DbConnection.

(Inherited from DbConnection)
GetSchema(String) GetSchema(String) GetSchema(String) GetSchema(String)

Devuelve información de esquema para el origen de datos de DbConnection utilizando la cadena especificada para el nombre del esquema.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

(Inherited from DbConnection)
GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[]) 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.Returns schema information for the data source of this DbConnection using the specified string for the schema name and the specified string array for the restriction values.

(Inherited from DbConnection)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs)

Genera el evento StateChange.Raises the StateChange event.

(Inherited from DbConnection)
Open() Open() Open() Open()

Establece una conexión con el origen de datos llamando al método Open del proveedor de datos subyacente.Establishes a connection to the data source by calling the underlying data provider's Open method.

OpenAsync() OpenAsync() OpenAsync() OpenAsync()

Una versión asincrónica de Open(), que abre una conexión a bases de datos con los valores especificados por ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Este método invoca el método virtual OpenAsync(CancellationToken) con CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

(Inherited from DbConnection)
OpenAsync(CancellationToken) OpenAsync(CancellationToken) OpenAsync(CancellationToken) OpenAsync(CancellationToken)

Esta es la versión asincrónica de Open().This is the asynchronous version of Open(). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. El token de cancelación se puede aceptar opcionalmente.The cancellation token can optionally be honored.

La implementación predeterminada invoca la llamada sincrónica a Open() y devuelve una tarea completada.The default implementation invokes the synchronous Open() call and returns a completed task. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Las excepciones producidas por Open se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by Open will be communicated via the returned Task Exception property.

No invoque otros métodos y propiedades del objeto DbConnection hasta que se haya completado la tarea devuelta.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

(Inherited from DbConnection)
ToString() ToString() ToString() ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Inherited from Component)

Eventos

Disposed Disposed Disposed Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
StateChange StateChange StateChange StateChange

Se produce cuando cambia el estado del evento.Occurs when the state of the event changes.

(Inherited from DbConnection)

Implementaciones de interfaz explícitas

IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction()

Inicia una transacción de base de datos.Begins a database transaction.

(Inherited from DbConnection)
IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel)

Inicia una transacción de base de datos con el valor de IsolationLevel especificado.Begins a database transaction with the specified IsolationLevel value.

(Inherited from DbConnection)
IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand()

Crea y devuelve un objeto DbCommand asociado a la conexión actual.Creates and returns a DbCommand object that is associated with the current connection.

(Inherited from DbConnection)

Se aplica a

Consulte también: