DbConnection Classe

Definição

Espaço de Nomes:
System.Data.Common
Assemblagem:
System.Data.Common.dll
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Define o comportamento central das ligações à base de dados e fornece uma classe base para ligações específicas da base de dados.

public ref class DbConnection abstract : IDisposable
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, 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
type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable
Public MustInherit Class DbConnection
Implements 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
Object
DbConnection
Herança
Object
MarshalByRefObject
Component
DbConnection
Derivado
Implementações
IDisposable IDbConnection IAsyncDisposable

Notas para Implementadores

Quando herda de DbConnection, deve sobrepor-se aos seguintes membros: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), e StateChange. Deve também fornecer as seguintes propriedades: ConnectionString, Database, DataSource, ServerVersion, e State.

Construtores

Name Description
DbConnection()

Inicializa uma nova instância da DbConnection classe.

Propriedades

Name Description
CanRaiseEvents

Obtém um valor que indica se o componente pode gerar um evento.

(Herdado de Component)
ConnectionString

Quando sobrescrito numa classe derivada, obtém ou define a cadeia usada para abrir a ligação.
ConnectionTimeout

Tem tempo de espera (em segundos) enquanto estabelece uma ligação antes de terminar a tentativa e gerar um erro.
Container

Obtém o IContainer que contém o Component.

(Herdado de Component)
Database

Quando sobrescrito numa classe derivada, recebe o nome da base de dados atual após a abertura de uma ligação, ou o nome da base de dados especificado na cadeia de ligação antes da abertura da ligação.
DataSource

Quando sobrescrito numa classe derivada, obtém o nome do servidor de base de dados ao qual se deve ligar.
DbProviderFactory

Recebe o DbProviderFactory por isto DbConnection.
DesignMode

Obtém um valor que indica se o Component está atualmente em modo de design.

(Herdado de Component)
Events

Obtém a lista de gestores de eventos que estão ligados a isto Component.

(Herdado de Component)
ServerVersion

Quando sobrescrito numa classe derivada, obtém uma cadeia que representa a versão do servidor a que o objeto está ligado.
Site

Obtém ou define o ISite do Component.

(Herdado de Component)
State

Obtém um valor que descreve o estado da ligação.

Métodos

Name Description
BeginDbTransaction(IsolationLevel)

Quando é sobreposto numa classe derivada, inicia uma transação de base de dados.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Inicia assíncronamente uma transação na base de dados.
BeginTransaction()

Inicia uma transação na base de dados.
BeginTransaction(IsolationLevel)

Inicia uma transação de base de dados com o nível de isolamento especificado.
BeginTransactionAsync(CancellationToken)

Inicia de forma assíncrona uma transação na base de dados.
BeginTransactionAsync(IsolationLevel, CancellationToken)

Inicia de forma assíncrona uma transação na base de dados.
ChangeDatabase(String)

Quando é sobreposto numa classe derivada, altera a base de dados atual para uma ligação aberta.
ChangeDatabaseAsync(String, CancellationToken)

Altera assíncronamente a base de dados atual para uma ligação aberta.
Close()

Quando sobreposto numa classe derivada, fecha a ligação à base de dados.
CloseAsync()

Fecha assíncronamente a ligação à base de dados.
CreateCommand()

Cria e devolve um DbCommand objeto associado à ligação atual.
CreateDbCommand()

Quando sobreposto numa classe derivada, cria e devolve um DbCommand objeto associado à ligação atual.
CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Realiza tarefas definidas pela aplicação associadas à libertação, libertação ou reinício de recursos não geridos.
Dispose()

Liberta todos os recursos utilizados pelo Component.

(Herdado de Component)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo DbConnection e opcionalmente liberta os recursos geridos.
Dispose(Boolean)

Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos.

(Herdado de Component)
DisposeAsync()

Dispõe assíncronamente o objeto de ligação.
EnlistTransaction(Transaction)

Aliste-se na transação especificada.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetSchema()

Devolve informação de esquema para a fonte de dados deste DbConnection.
GetSchema(String, String[])

Devolve a informação do esquema para a fonte de dados desta DbConnection usando a cadeia especificada para o nome do esquema e o array de cadeias especificado para os valores de restrição.
GetSchema(String)

Devolve a informação do esquema para a fonte de dados desta DbConnection usando a cadeia especificada para o nome do esquema.
GetService(Type)

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

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Eleva o StateChange evento.
Open()

Quando é sobreposto numa classe derivada, abre uma ligação à base de dados com as definições especificadas pelo ConnectionString.
OpenAsync()

Uma versão assíncrona de Open(), que abre uma ligação à base de dados com as definições especificadas pelo ConnectionString. Este método invoca o método OpenAsync(CancellationToken) virtual com CancellationToken.None.
OpenAsync(CancellationToken)

Esta é a versão assíncrona de Open(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode ser opcionalmente aceito.

A implementação padrão invoca a chamada síncrona Open() e devolve uma tarefa concluída. A implementação padrão devolverá uma tarefa cancelada se for passada uma cancellationToken já cancelada. As exceções lançadas pelo Open serão comunicadas através da propriedade de Exceção de Tarefa devolvida.

Não invoque outros métodos e propriedades do DbConnection objeto até que a tarefa devolvida esteja concluída.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
ToString()

Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado.

(Herdado de Component)

evento

Name Description
Disposed

Ocorre quando o componente é eliminado por uma chamada ao Dispose() método.

(Herdado de Component)
StateChange

Ocorre quando o estado da ligação muda.

Implementações de Interface Explícita

Name Description
IDbConnection.BeginTransaction()

Inicia uma transação de base de dados.
IDbConnection.BeginTransaction(IsolationLevel)

Inicia uma transação de base de dados com o nível de isolamento especificado.
IDbConnection.CreateCommand()

Cria e devolve um DbCommand objeto associado à ligação atual.

Métodos da Extensão

Name Description
ConfigureAwait(IAsyncDisposable, Boolean)

Configura como aguarda nas tarefas devolvidas de um descartável assíncrono será realizada.

Aplica-se a

Ver também