DbConnection Classe

Definição

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.Defines the core behavior of database connections and provides a base class for database-specific connections.

public ref class DbConnection abstract : IDisposable
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, IAsyncDisposable, 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 : IDisposable, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IDisposable, System.Data.IDbConnection
public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, 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
    interface IDbConnection
    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
Implements IDbConnection, IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable
Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, 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.When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. Você também deve fornecer as seguintes propriedades: ConnectionString, Database, DataSource, ServerVersione State.You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

Construtores

DbConnection()

Inicia uma nova instância da classe DbConnection.Initializes a new instance of the DbConnection class.

Propriedades

CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(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.When overridden in a derived class, gets or sets the string used to open the connection.

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.Gets the time to wait (in seconds) while establishing a connection before terminating the attempt and generating an error.

Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the 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.When overridden in a derived class, gets the name of the current database after a connection is opened, or the database name specified in the connection string before the connection is opened.

DataSource

Quando substituído em uma classe derivada, obtém o nome do servidor de banco de dados ao qual se conectar.When overridden in a derived class, gets the name of the database server to which to connect.

DbProviderFactory

Obtém o DbProviderFactory para este DbConnection.Gets the DbProviderFactory for this DbConnection.

DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Herdado de Component)
Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this 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.When overridden in a derived class, gets a string that represents the version of the server to which the object is connected.

Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Herdado de Component)
State

Obtém uma cadeia de caracteres que descreve o estado da conexão.Gets a string that describes the state of the connection.

Métodos

BeginDbTransaction(IsolationLevel)

Quando substituído em uma classe derivada, inicia uma transação de banco de dados.When overridden in a derived class, starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Inicia de maneira assíncrona uma transação de banco de dados.Asynchronously starts a database transaction.

BeginTransaction()

Inicia uma transação do banco de dados.Starts a database transaction.

BeginTransaction(IsolationLevel)

Inicia uma transação de banco de dados com o nível de isolamento especificado.Starts a database transaction with the specified isolation level.

BeginTransactionAsync(CancellationToken)

Inicia de maneira assíncrona uma transação de banco de dados.Asynchronously begins a database transaction.

BeginTransactionAsync(IsolationLevel, CancellationToken)

Inicia de maneira assíncrona uma transação de banco de dados.Asynchronously begins a database transaction.

ChangeDatabase(String)

Quando substituído em uma classe derivada, troca o banco de dados atual por uma conexão aberta.When overridden in a derived class, changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken)

Troca de forma assíncrona o banco de dados atual por uma conexão aberta.Asynchronously changes the current database for an open connection.

Close()

Quando substituído em uma classe derivada, fecha a conexão com o banco de dados.When overridden in a derived class, closes the connection to the database.

CloseAsync()

Fecha de maneira assíncrona a conexão com o banco de dados.Asynchronously closes the connection to the database.

CreateCommand()

Cria e retorna um objeto DbCommand associado à conexão atual.Creates and returns a DbCommand object associated with the current connection.

CreateDbCommand()

Quando substituído em uma classe derivada, cria e retorna um objeto DbCommand associado à conexão atual.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()
Dispose(Boolean)
DisposeAsync()

Descarta de forma assíncrona o objeto da conexão.Asynchronously diposes the connection object.

EnlistTransaction(Transaction)

Inscreve-se na transação especificada.Enlists in the specified transaction.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetSchema()

Retorna informações de esquema para a fonte de dados deste DbConnection.Returns schema information for the data source of this 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.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

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.Returns schema information for the data source of this DbConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Gera o evento StateChange.Raises the StateChange event.

Open()

Quando substituído em uma classe derivada, abre uma conexão de banco de dados com as configurações especificadas pelo ConnectionString.When overridden in a derived class, opens a database connection with the settings specified by the 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.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Esse método invoca o método virtual OpenAsync(CancellationToken) com CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Essa é a versão assíncrona de Open().This is the asynchronous version of Open(). Provedores devem substituir com uma implementação apropriada.Providers should override with an appropriate implementation. Opcionalmente, o token de cancelamento pode ser respeitado.The cancellation token can optionally be honored.

A implementação padrão invoca a chamada Open() síncrona e retorna uma tarefa concluída.The default implementation invokes the synchronous Open() call and returns a completed task. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Exceções geradas por Open serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Não invoque outros métodos e propriedades do objeto DbConnection até a Tarefa retornada ser concluída.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Herdado de Component)

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Herdado de Component)
StateChange

Ocorre quando o estado da conexão é alterado.Occurs when the state of the connection changes.

Implantações explícitas de interface

IDbConnection.BeginTransaction()

Inicia uma transação de banco de dados.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel)

Inicia uma transação de banco de dados com o nível de isolamento especificado.Begins a database transaction with the specified isolation level.

IDbConnection.CreateCommand()

Cria e retorna um objeto DbCommand associado à conexão atual.Creates and returns a DbCommand object that is associated with the current connection.

Aplica-se a

Veja também