DbConnection Classe

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbConnection.cs

Define o comportamento principal das conexões de banco de dados e fornece uma classe base para conexões específicas de 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 essa instância DbConnection dá suporte à classe DbBatch.
CanRaiseEvents	Obtém um valor que indica se o componente pode gerar 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) ao estabelecer uma conexão antes de encerrar a tentativa e gerar um erro.
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 é 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 deste DbConnection.
DesignMode	Obtém um valor que indica se o Component está atualmente no modo de design. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos 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 à 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 forma 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 forma assíncrona uma transação de banco de dados.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Inicia de forma assíncrona uma transação de banco de dados.
ChangeDatabase(String)	Quando substituído em uma classe derivada, altera o banco de dados atual para uma conexão aberta.
ChangeDatabaseAsync(String, CancellationToken)	Altera de forma assíncrona o banco de dados atual para uma conexão aberta.
Close()	Quando substituído em uma classe derivada, fecha a conexão com o banco de dados.
CloseAsync()	Fecha assíncronamente 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 classe DbBatch.
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()	Mergulha de forma assíncrona o objeto de conexão.
EnlistTransaction(Transaction)	Inscrição 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 tempo de vida para essa 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 deste 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)	Esta é uma versão assíncrona do GetSchema(). Os provedores devem substituir com uma implementação apropriada. O cancellationToken pode, opcionalmente, ser honrado. A implementação padrão invoca a chamada síncrona GetSchema() e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se aprovada uma cancellationTokenjá cancelada. As exceções geradas por GetSchema() serão comunicadas por meio da propriedade de Exceção de Tarefa retornada.
GetSchemaAsync(String, CancellationToken)	Esta é a versão assíncrona do GetSchema(String). Os provedores devem substituir com uma implementação apropriada. O cancellationToken pode, opcionalmente, ser honrado. A implementação padrão invoca a chamada síncrona GetSchema(String) e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se aprovada uma cancellationTokenjá cancelada. As exceções geradas por GetSchema(String) serão comunicadas por meio da propriedade de Exceção de Tarefa retornada.
GetSchemaAsync(String, String[], CancellationToken)	Esta é a versão assíncrona do GetSchema(String, String[]). Os provedores devem substituir com uma implementação apropriada. O cancellationToken pode, opcionalmente, ser honrado. A implementação padrão invoca a chamada síncrona GetSchema(String, String[]) e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se aprovada uma cancellationTokenjá cancelada. As exceções geradas por GetSchema(String, String[]) serão comunicadas por meio da propriedade de Exceção de Tarefa retornada.
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou por 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 dessa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Gera 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 do 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)	Esta é a versão assíncrona do Open(). Os provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser respeitado. A implementação padrão invoca a chamada síncrona Open() e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se aprovada um cancelamento já canceladoToken. As exceções geradas pelo Open serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto DbConnection até que a Tarefa retornada seja 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 é descartado por uma chamada para o 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 serão executadas.

Confira também

• DbProviderFactories (ADO.NET)
• visão geral ADO.NET