Compartilhar via


DbConnection Classe

Definição

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 : 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
Herança
DbConnection
Herança
Derivado
Implementações

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

Executa tarefas definidas pelo aplicativo associadas à liberação, liberação ou redefinição de recursos não gerenciados.

Dispose()

Libera todos os recursos usados pelo Component.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DbConnection e, opcionalmente, libera os recursos gerenciados.

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 uma cadeia de caracteres que representa o objeto atual.

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

Aplica-se a

Confira também

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