DbConnection DbConnection DbConnection DbConnection Class

Definición

Representa una conexión a una base de datos.Represents a connection to a database.

public ref class DbConnection abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IDisposable, System.Data.IDbConnection
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable
Herencia
Derivado
Implementaciones

Notas a los desarrolladores de herederos

Al heredar de DbConnection, debe reemplazar los miembros siguientes: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), y StateChange.When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. También debe proporcionar las siguientes propiedades: ConnectionString, Database, DataSource, ServerVersion, y State.You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

Constructores

DbConnection() DbConnection() DbConnection() DbConnection()

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

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 que se utiliza para abrir la conexión.Gets or sets the string used to open the connection.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Obtiene el tiempo de espera para establecer una conexión antes de detener el intento y generar un error.Gets the time to wait while establishing a connection before terminating 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 después de abrir una conexión, o el nombre de la base de datos especificada en la cadena de conexión antes de que se abra la conexión.Gets the name of the current database after a connection is opened, or the database name specified in the connection string before the connection is opened.

DataSource DataSource DataSource DataSource

Obtiene el nombre del servidor de bases de datos con el que se va a establecer la conexión.Gets the name of the database server to which to connect.

DbProviderFactory DbProviderFactory DbProviderFactory DbProviderFactory

Obtiene el objeto DbProviderFactory para este objeto DbConnection.Gets the DbProviderFactory for this 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 representa la versión del servidor al que está conectado el objeto.Gets a string that represents the version of the server to which the object 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 una cadena que describe el estado de la conexión.Gets a string that describes the state of the connection.

Métodos

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

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

BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

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

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

Inicia una transacción de base de datos con el nivel de aislamiento especificado.Starts a database transaction with the specified isolation level.

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

Cambia la base de datos actual para una conexión abierta.Changes the current database for an open connection.

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

Cierra la conexión con la base de datos.Closes the connection to the database. Es el método preferido para cerrar cualquier conexión abierta.This is the preferred method of closing any open connection.

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

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

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.

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()
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

Da de alta en la transacción especificada.Enlists 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)
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.

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.

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.

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.

Open() Open() Open() Open()

Abre una conexión a base de datos con la configuración que especifica ConnectionString.Opens a database connection with the settings specified by the ConnectionString.

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.

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.

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.

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.

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.

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.

Se aplica a

Consulte también: