DbConnection Classe

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbConnection.cs

Define o comportamento básico das conexões de banco de dados e fornece uma classe base para conexões específicas do banco de dados.

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

Herança

Object

MarshalByRefObject

Component

DbConnection

Derivado

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.SqlClient.SqlConnection

Implementações

IDisposable IDbConnection IAsyncDisposable

Notas aos Implementadores

Ao herdar de DbConnection, você deve substituir os seguintes membros: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), , Open()e StateChange. Você também deve fornecer as seguintes propriedades: ConnectionString, Database, DataSource, ServerVersione State.

Construtores

DbConnection()

Inicializa uma nova instância da classe DbConnection.

Propriedades

CanCreateBatch	Obtém um valor que indica se esta instância DbConnection é compatível com a classe DbBatch.
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
ConnectionString	Quando substituído em uma classe derivada, obtém ou define a cadeia de caracteres usada para abrir a conexão.
ConnectionTimeout	Obtém o tempo de espera (em segundos) durante o estabelecimento da conexão antes que a tentativa seja finalizada e um erro seja gerado.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
Database	Quando substituído em uma classe derivada, obtém o nome do banco de dados atual depois que uma conexão for aberta ou o nome do banco de dados especificado na cadeia de conexão antes da conexão ser aberta.
DataSource	Quando substituído em uma classe derivada, obtém o nome do servidor de banco de dados ao qual se conectar.
DbProviderFactory	Obtém o DbProviderFactory para este DbConnection.
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
ServerVersion	Quando substituído em uma classe derivada, obtém uma cadeia de caracteres que representa a versão do servidor ao qual o objeto está conectado.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
State	Obtém uma cadeia de caracteres que descreve o estado da conexão.

Métodos

BeginDbTransaction(IsolationLevel)	Quando substituído em uma classe derivada, inicia uma transação de banco de dados.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Inicia de maneira assíncrona uma transação de banco de dados.
BeginTransaction()	Inicia uma transação de banco de dados.
BeginTransaction(IsolationLevel)	Inicia uma transação de banco de dados com o nível de isolamento especificado.
BeginTransactionAsync(CancellationToken)	Inicia de maneira assíncrona uma transação de banco de dados.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Inicia de maneira assíncrona uma transação de banco de dados.
ChangeDatabase(String)	Quando substituído em uma classe derivada, troca o banco de dados atual por uma conexão aberta.
ChangeDatabaseAsync(String, CancellationToken)	Troca de forma assíncrona o banco de dados atual por uma conexão aberta.
Close()	Quando substituído em uma classe derivada, fecha a conexão com o banco de dados.
CloseAsync()	Fecha de maneira assíncrona a conexão com o banco de dados.
CreateBatch()	Retorna uma nova instância da classe do provedor que implementa a classe DbBatch .
CreateCommand()	Cria e retorna um objeto DbCommand associado à conexão atual.
CreateDbBatch()	Quando substituído em uma classe derivada, retorna uma nova instância da classe do provedor que implementa a DbBatch classe .
CreateDbCommand()	Quando substituído em uma classe derivada, cria e retorna um objeto DbCommand associado à conexão atual.
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
DisposeAsync()	Descarta de forma assíncrona o objeto da conexão.
EnlistTransaction(Transaction)	Inscreve-se na transação especificada.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetSchema()	Retorna informações de esquema para a fonte de dados deste DbConnection.
GetSchema(String)	Retorna informações de esquema para a fonte de dados deste DbConnection usando a cadeia de caracteres especificada para o nome do esquema.
GetSchema(String, String[])	Retorna informações de esquema para a fonte de dados desse DbConnection usando a cadeia de caracteres especificada para o nome do esquema e a matriz de cadeia de caracteres especificada para os valores de restrição.
GetSchemaAsync(CancellationToken)	Essa é uma versão assíncrona de GetSchema(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o cancellationToken pode ser respeitado. A implementação padrão invoca a chamada GetSchema() síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado. Exceções geradas por GetSchema() serão comunicadas por meio da propriedade Exceção de Tarefa retornada.
GetSchemaAsync(String, CancellationToken)	Essa é a versão assíncrona de GetSchema(String). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o cancellationToken pode ser respeitado. A implementação padrão invoca a chamada GetSchema(String) síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado. Exceções geradas por GetSchema(String) serão comunicadas por meio da propriedade Exceção de Tarefa retornada.
GetSchemaAsync(String, String[], CancellationToken)	Essa é a versão assíncrona de GetSchema(String, String[]). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o cancellationToken pode ser respeitado. A implementação padrão invoca a chamada GetSchema(String, String[]) síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado. Exceções geradas por GetSchema(String, String[]) serão comunicadas por meio da propriedade Exceção de Tarefa retornada.
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Aciona o evento StateChange.
Open()	Quando substituído em uma classe derivada, abre uma conexão de banco de dados com as configurações especificadas pelo ConnectionString.
OpenAsync()	Uma versão assíncrona de Open(), que abre uma conexão de banco de dados com as configurações especificadas pelo ConnectionString. Esse método invoca o método virtual OpenAsync(CancellationToken) com CancellationToken.None.
OpenAsync(CancellationToken)	Essa é a versão assíncrona de Open(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser respeitado. A implementação padrão invoca a chamada Open() síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado. Exceções geradas por Open serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto DbConnection até a Tarefa retornada ser concluída.
ToString()	Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component)

Eventos

Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)
StateChange	Ocorre quando o estado da conexão é alterado.

Implantações explícitas de interface

IDbConnection.BeginTransaction()	Inicia uma transação de banco de dados.
IDbConnection.BeginTransaction(IsolationLevel)	Inicia uma transação de banco de dados com o nível de isolamento especificado.
IDbConnection.CreateCommand()	Cria e retorna um objeto DbCommand associado à conexão atual.

Métodos de Extensão

ConfigureAwait(IAsyncDisposable, Boolean)

Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas.

Confira também

• DbProviderFactories (ADO.NET)
• Visão geral do ADO.NET