DbConnection Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Origine:

DbConnection.cs

Definisce il comportamento principale delle connessioni di database e fornisce una classe base per le connessioni specifiche del database.

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

Ereditarietà

Object

MarshalByRefObject

Component

DbConnection

Derivato

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.SqlClient.SqlConnection

Implementazioni

IDisposable IDbConnection IAsyncDisposable

Note per gli implementatori

Quando si eredita da DbConnection, è necessario eseguire l'override dei membri seguenti: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open()e StateChange. È inoltre necessario specificare le proprietà seguenti: ConnectionString, Database, DataSource, ServerVersione State.

Costruttori

DbConnection()

Inizializza una nuova istanza della classe DbConnection.

Proprietà

CanCreateBatch	Ottiene un valore che indica se questa istanza di DbConnection supporta la classe DbBatch.
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
ConnectionString	Quando sottoposto a override in una classe derivata, ottiene o imposta la stringa utilizzata per aprire la connessione.
ConnectionTimeout	Ottiene il tempo di attesa (in secondi) durante la creazione di una connessione prima di terminare il tentativo e generare un errore.
Container	Ottiene il IContainer che contiene il Component. (Ereditato da Component)
Database	In caso di override in una classe derivata, ottiene il nome del database corrente dopo l'apertura di una connessione o il nome del database specificato nella stringa di connessione prima dell'apertura della connessione.
DataSource	In caso di override in una classe derivata, ottiene il nome del server di database a cui connettersi.
DbProviderFactory	Ottiene il DbProviderFactory per questo DbConnection.
DesignMode	Ottiene un valore che indica se la Component è attualmente in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi associati a questo Component. (Ereditato da Component)
ServerVersion	Quando sottoposto a override in una classe derivata, ottiene una stringa che rappresenta la versione del server a cui è connesso l'oggetto.
Site	Ottiene o imposta il ISite del Component. (Ereditato da Component)
State	Ottiene una stringa che descrive lo stato della connessione.

Metodi

BeginDbTransaction(IsolationLevel)	Quando sottoposto a override in una classe derivata, avvia una transazione di database.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Avvia in modo asincrono una transazione di database.
BeginTransaction()	Avvia una transazione di database.
BeginTransaction(IsolationLevel)	Avvia una transazione di database con il livello di isolamento specificato.
BeginTransactionAsync(CancellationToken)	Avvia in modo asincrono una transazione di database.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Avvia in modo asincrono una transazione di database.
ChangeDatabase(String)	Quando sottoposto a override in una classe derivata, modifica il database corrente per una connessione aperta.
ChangeDatabaseAsync(String, CancellationToken)	Modifica in modo asincrono il database corrente per una connessione aperta.
Close()	Quando sottoposto a override in una classe derivata, chiude la connessione al database.
CloseAsync()	Chiude in modo asincrono la connessione al database.
CreateBatch()	Restituisce una nuova istanza della classe del provider che implementa la classe DbBatch.
CreateCommand()	Crea e restituisce un oggetto DbCommand associato alla connessione corrente.
CreateDbBatch()	Quando sottoposto a override in una classe derivata, restituisce una nuova istanza della classe del provider che implementa la classe DbBatch.
CreateDbCommand()	Quando sottoposto a override in una classe derivata, crea e restituisce un oggetto DbCommand associato alla connessione corrente.
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate dal Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate dal Component e, facoltativamente, rilascia le risorse gestite. (Ereditato da Component)
DisposeAsync()	Depose in modo asincrono l'oggetto connessione.
EnlistTransaction(Transaction)	Inserisce nella transazione specificata.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetSchema()	Restituisce informazioni sullo schema per l'origine dati di questo DbConnection.
GetSchema(String)	Restituisce informazioni sullo schema per l'origine dati di questo DbConnection utilizzando la stringa specificata per il nome dello schema.
GetSchema(String, String[])	Restituisce informazioni sullo schema per l'origine dati di questo DbConnection utilizzando la stringa specificata per il nome dello schema e la matrice di stringhe specificata per i valori di restrizione.
GetSchemaAsync(CancellationToken)	Si tratta di una versione asincrona di GetSchema(). I provider devono eseguire l'override con un'implementazione appropriata. Il cancellationToken può essere rispettato facoltativamente. L'implementazione predefinita richiama la GetSchema() sincrona e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stata passata una cancellationTokengià annullata. Le eccezioni generate da GetSchema() verranno comunicate tramite la proprietà Task Exception restituita.
GetSchemaAsync(String, CancellationToken)	Si tratta della versione asincrona di GetSchema(String). I provider devono eseguire l'override con un'implementazione appropriata. Il cancellationToken può essere rispettato facoltativamente. L'implementazione predefinita richiama la GetSchema(String) sincrona e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stata passata una cancellationTokengià annullata. Le eccezioni generate da GetSchema(String) verranno comunicate tramite la proprietà Task Exception restituita.
GetSchemaAsync(String, String[], CancellationToken)	Si tratta della versione asincrona di GetSchema(String, String[]). I provider devono eseguire l'override con un'implementazione appropriata. Il cancellationToken può essere rispettato facoltativamente. L'implementazione predefinita richiama la GetSchema(String, String[]) sincrona e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stata passata una cancellationTokengià annullata. Le eccezioni generate da GetSchema(String, String[]) verranno comunicate tramite la proprietà Task Exception restituita.
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito dal Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Genera l'evento StateChange.
Open()	Quando sottoposto a override in una classe derivata, apre una connessione di database con le impostazioni specificate dal ConnectionString.
OpenAsync()	Versione asincrona di Open(), che apre una connessione di database con le impostazioni specificate dal ConnectionString. Questo metodo richiama il metodo virtuale OpenAsync(CancellationToken) con CancellationToken.None.
OpenAsync(CancellationToken)	Si tratta della versione asincrona di Open(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può essere facoltativamente rispettato. L'implementazione predefinita richiama la Open() sincrona e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stato passato un oggetto cancellationToken già annullato. Le eccezioni generate da Open verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto DbConnection fino al completamento dell'attività restituita.
ToString()	Restituisce un String contenente il nome del Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)

Eventi

Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)
StateChange	Si verifica quando lo stato della connessione cambia.

Implementazioni dell'interfaccia esplicita

IDbConnection.BeginTransaction()	Avvia una transazione di database.
IDbConnection.BeginTransaction(IsolationLevel)	Avvia una transazione di database con il livello di isolamento specificato.
IDbConnection.CreateCommand()	Crea e restituisce un oggetto DbCommand associato alla connessione corrente.

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono.

Vedi anche

• dbProviderFactories (ADO.NET)
• ADO.NET Panoramica