DbConnection Clase

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Source:

DbConnection.cs

Define el comportamiento principal de las conexiones de base de datos y proporciona una clase base para conexiones específicas de la base de datos.

public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbConnection

public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbConnection

type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection, IDisposable

Herencia

Object

MarshalByRefObject

Component

DbConnection

Derivado

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.SqlClient.SqlConnection

Implementaciones

IDisposable IDbConnection IAsyncDisposable

Notas a los implementadores

Al heredar de DbConnection, debe invalidar los siguientes miembros: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open()y StateChange. También debe proporcionar las siguientes propiedades: ConnectionString, Database, DataSource, ServerVersiony State.

Constructores

DbConnection()

Inicializa una nueva instancia de la clase DbConnection.

Propiedades

CanCreateBatch	Obtiene un valor que indica si esta instancia de DbConnection admite la clase DbBatch.
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
ConnectionString	Cuando se invalida en una clase derivada, obtiene o establece la cadena utilizada para abrir la conexión.
ConnectionTimeout	Obtiene el tiempo de espera (en segundos) al establecer una conexión antes de finalizar el intento y generar un error.
Container	Obtiene el IContainer que contiene el Component. (Heredado de Component)
Database	Cuando se reemplaza en una clase derivada, obtiene el nombre de la base de datos actual después de abrir una conexión o el nombre de la base de datos especificado en la cadena de conexión antes de que se abra la conexión.
DataSource	Cuando se reemplaza en una clase derivada, obtiene el nombre del servidor de base de datos al que se va a conectar.
DbProviderFactory	Obtiene el DbProviderFactory de este DbConnection.
DesignMode	Obtiene un valor que indica si el Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos que están asociados a este 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.
Site	Obtiene o establece el ISite del Component. (Heredado de Component)
State	Obtiene una cadena que describe el estado de la conexión.

Métodos

BeginDbTransaction(IsolationLevel)	Cuando se invalida en una clase derivada, inicia una transacción de base de datos.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Inicia de forma asincrónica una transacción de base de datos.
BeginTransaction()	Inicia una transacción de base de datos.
BeginTransaction(IsolationLevel)	Inicia una transacción de base de datos con el nivel de aislamiento especificado.
BeginTransactionAsync(CancellationToken)	Inicia de forma asincrónica una transacción de base de datos.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Inicia de forma asincrónica una transacción de base de datos.
ChangeDatabase(String)	Cuando se invalida en una clase derivada, cambia la base de datos actual para una conexión abierta.
ChangeDatabaseAsync(String, CancellationToken)	Cambia de forma asincrónica la base de datos actual para una conexión abierta.
Close()	Cuando se invalida en una clase derivada, cierra la conexión a la base de datos.
CloseAsync()	Cierra de forma asincrónica la conexión a la base de datos.
CreateBatch()	Devuelve una nueva instancia de la clase del proveedor que implementa la clase DbBatch.
CreateCommand()	Crea y devuelve un objeto DbCommand asociado a la conexión actual.
CreateDbBatch()	Cuando se reemplaza en una clase derivada, devuelve una nueva instancia de la clase del proveedor que implementa la clase DbBatch.
CreateDbCommand()	Cuando se reemplaza en una clase derivada, crea y devuelve un objeto DbCommand asociado a la conexión actual.
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)
Dispose()	Libera todos los recursos usados por el Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados usados por el Component y, opcionalmente, libera los recursos administrados. (Heredado de Component)
DisposeAsync()	De forma asincrónica se dipa el objeto de conexión.
EnlistTransaction(Transaction)	Se inscribe en la transacción especificada.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetHashCode()	Actúa como 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)
GetSchema()	Devuelve información de esquema para el origen de datos de este 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.
GetSchema(String, String[])	Devuelve información de esquema para el origen de datos de este DbConnection utilizando la cadena especificada para el nombre del esquema y la matriz de cadenas especificada para los valores de restricción.
GetSchemaAsync(CancellationToken)	Se trata de una versión asincrónica de GetSchema(). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el cancellationToken. La implementación predeterminada invoca la llamada GetSchema() sincrónica y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationTokenya cancelada. Las excepciones producidas por GetSchema() se comunicarán a través de la propiedad Task Exception devuelta.
GetSchemaAsync(String, CancellationToken)	Esta es la versión asincrónica de GetSchema(String). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el cancellationToken. La implementación predeterminada invoca la llamada GetSchema(String) sincrónica y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationTokenya cancelada. Las excepciones producidas por GetSchema(String) se comunicarán a través de la propiedad Task Exception devuelta.
GetSchemaAsync(String, String[], CancellationToken)	Esta es la versión asincrónica de GetSchema(String, String[]). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el cancellationToken. La implementación predeterminada invoca la llamada GetSchema(String, String[]) sincrónica y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationTokenya cancelada. Las excepciones producidas por GetSchema(String, String[]) se comunicarán a través de la propiedad Task Exception devuelta.
GetService(Type)	Devuelve un objeto que representa un servicio proporcionado por el Component o por su 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 Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Genera el evento StateChange.
Open()	Cuando se invalida en una clase derivada, abre una conexión de base de datos con la configuración especificada por el ConnectionString.
OpenAsync()	Una versión asincrónica de Open(), que abre una conexión de base de datos con la configuración especificada por el ConnectionString. Este método invoca el método virtual OpenAsync(CancellationToken) con CancellationToken.None.
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 Open() sincrónica 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 objeto DbConnection hasta que se complete la tarea devuelta.
ToString()	Devuelve un String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)

Eventos

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

Implementaciones de interfaz explícitas

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

Métodos de extensión

ConfigureAwait(IAsyncDisposable, Boolean)

Configura cómo se realizarán las esperas en las tareas devueltas desde un descartable asincrónico.

Consulte también

• DbProviderFactories (ADO.NET)
• información general de ADO.NET