DbConnection Clase

Definición

Define el comportamiento básico de las conexiones de base de datos y proporciona una clase base para las conexiones específicas de base de datos.Defines the core behavior of database connections and provides a base class for database-specific connections.

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

Notas a los implementadores

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 propiedades siguientes: ConnectionString , Database , DataSource , ServerVersion y State .You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

Constructores

DbConnection()

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

Propiedades

CanRaiseEvents

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

(Heredado de Component)
ConnectionString

Cuando se invalida en una clase derivada, obtiene o establece la cadena utilizada para abrir la conexión.When overridden in a derived class, gets or sets the string used to open the connection.

ConnectionTimeout

Obtiene el tiempo de espera (en segundos) mientras se establece una conexión hasta que se interrumpe el intento y se genera un error.Gets the time to wait (in seconds) while establishing a connection before terminating the attempt and generating an error.

Container

Obtiene la interfaz IContainer que contiene la clase Component.Gets the IContainer that contains the Component.

(Heredado de Component)
Database

Cuando se reemplaza en una clase deriva, 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.When overridden in a derived class, 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

Cuando se invalida en una clase derivada, obtiene el nombre de la base de datos con la que se debe conectar.When overridden in a derived class, gets the name of the database server to which to connect.

DbProviderFactory

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

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.

(Heredado de Component)
Events

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

(Heredado de Component)
ServerVersion

Cuando se reemplaza en una clase derivada, obtiene una cadena que representa la versión del servidor al que está conectado el objeto.When overridden in a derived class, gets a string that represents the version of the server to which the object is connected.

Site

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

(Heredado de Component)
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)

Cuando se invalida en una clase derivada, inicia una transacción de base de datos.When overridden in a derived class, starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Inicia de forma asincrónica una transacción de base de datos.Asynchronously starts a database transaction.

BeginTransaction()

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

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.

BeginTransactionAsync(CancellationToken)

Empieza de forma asincrónica una transacción de base de datos.Asynchronously begins a database transaction.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Empieza de forma asincrónica una transacción de base de datos.Asynchronously begins a database transaction.

ChangeDatabase(String)

Cuando se reemplaza en una clase derivada, cambia la base de datos actual para una conexión abierta.When overridden in a derived class, changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken)

Cambia de forma asincrónica la base de datos actual de una conexión abierta.Asynchronously changes the current database for an open connection.

Close()

Cuando se invalida en una clase derivada, cierra la conexión con la base de datos.When overridden in a derived class, closes the connection to the database.

CloseAsync()

Cierra de forma asincrónica la conexión con la base de datos.Asynchronously closes the connection to the database.

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()

Cuando se reemplaza en una clase derivada, crea y devuelve un objeto DbCommand asociado a la conexión actual.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

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.

(Heredado de MarshalByRefObject)
Dispose()

Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa DbConnection y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the DbConnection and optionally releases the managed resources.

Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Heredado de Component)
DisposeAsync()

Desecha de forma asincrónica el objeto de conexión.Asynchronously diposes the connection object.

EnlistTransaction(Transaction)

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

Equals(Object)

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

(Heredado de Object)
GetHashCode()

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

(Heredado de Object)
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.

(Heredado de MarshalByRefObject)
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)

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[])

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.

GetSchemaAsync(CancellationToken)

Esta es una versión asincrónica de GetSchema().This is an asynchronous version of GetSchema(). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. Opcionalmente, se puede respetar cancellationToken.The cancellationToken can optionally be honored. La implementación predeterminada invoca la llamada sincrónica a GetSchema() y devuelve una tarea completada.The default implementation invokes the synchronous GetSchema() 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 GetSchema() se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by GetSchema() will be communicated via the returned Task Exception property.

GetSchemaAsync(String, CancellationToken)

Esta es la versión asincrónica de GetSchema(String).This is the asynchronous version of GetSchema(String). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. Opcionalmente, se puede respetar cancellationToken.The cancellationToken can optionally be honored. La implementación predeterminada invoca la llamada sincrónica a GetSchema(String) y devuelve una tarea completada.The default implementation invokes the synchronous GetSchema(String) 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 GetSchema(String) se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by GetSchema(String) will be communicated via the returned Task Exception property.

GetSchemaAsync(String, String[], CancellationToken)

Esta es la versión asincrónica de GetSchema(String, String[]).This is the asynchronous version of GetSchema(String, String[]). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. Opcionalmente, se puede respetar cancellationToken.The cancellationToken can optionally be honored. La implementación predeterminada invoca la llamada sincrónica a GetSchema(String, String[]) y devuelve una tarea completada.The default implementation invokes the synchronous GetSchema(String, String[]) 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 GetSchema(String, String[]) se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by GetSchema(String, String[]) will be communicated via the returned Task Exception property.

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.

(Heredado de Component)
GetType()

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

(Heredado de Object)
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.

(Heredado de MarshalByRefObject)
MemberwiseClone()

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

(Heredado de Object)
MemberwiseClone(Boolean)

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

(Heredado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Genera el evento StateChange.Raises the StateChange event.

Open()

Cuando se reemplaza en una clase derivada, abre una conexión de base de datos con los valores especificados por la ConnectionString.When overridden in a derived class, opens a database connection with the settings specified by the ConnectionString.

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)

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()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
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.

(Heredado de Component)

Eventos

Disposed

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

(Heredado de Component)
StateChange

Se produce cuando cambia el estado de la conexión.Occurs when the state of the connection changes.

Implementaciones de interfaz explícitas

IDbConnection.BeginTransaction()

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

IDbConnection.BeginTransaction(IsolationLevel)

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

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.

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura la forma en la que se realizan las expresiones await en las tareas devueltas desde un elemento asincrónico descartable.Configures how awaits on the tasks returned from an async disposable are performed.

Se aplica a

Consulte también