DbConnection Classe

Definizione

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

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
Ereditarietà
DbConnection
Ereditarietà
Derivato
Implementazioni

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

Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite.

Dispose()

Rilascia tutte le risorse usate dal Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate dal DbConnection e, facoltativamente, rilascia le risorse gestite.

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 una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
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.

Si applica a

Vedi anche