DbConnection Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Source:
DbConnection.cs
Source:
DbConnection.cs
Source:
DbConnection.cs

Definisce il comportamento principale delle connessioni al 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à
Object
DbConnection
Ereditarietà
Object
MarshalByRefObject
Component
DbConnection
Derivato
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. È anche 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

In caso di override in una classe derivata, ottiene o imposta la stringa usata per aprire la connessione.
ConnectionTimeout

Ottiene il tempo di attesa (in secondi) per stabilire una connessione prima di terminare il tentativo e generare un errore.
Container

Ottiene l'oggetto IContainer che contiene 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 che la connessione venga aperta.
DataSource

In caso di override in una classe derivata, ottiene il nome del server di database a cui connettersi.
DbProviderFactory

Ottiene l'oggetto DbProviderFactory per l'oggetto DbConnection.
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.

(Ereditato da Component)
ServerVersion

In caso di override in una classe derivata, ottiene una stringa che rappresenta la versione del server a cui l'oggetto è connesso.
Site

Ottiene o imposta l'oggetto ISite di Component.

(Ereditato da Component)
State

Ottiene una stringa che descrive lo stato della connessione.

Metodi

BeginDbTransaction(IsolationLevel)

In caso di override in una classe derivata, avvia una transazione di database.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Avvia una transazione di database in modo asincrono.
BeginTransaction()

Avvia una transazione di database.
BeginTransaction(IsolationLevel)

Inizia una transazione di database con il livello di isolamento specificato.
BeginTransactionAsync(CancellationToken)

Avvia una transazione di database in modo asincrono.
BeginTransactionAsync(IsolationLevel, CancellationToken)

Avvia una transazione di database in modo asincrono.
ChangeDatabase(String)

In caso di override in una classe derivata, modifica il database corrente per una connessione aperta.
ChangeDatabaseAsync(String, CancellationToken)

Cambia il database corrente in modo asincrono per una connessione aperta.
Close()

In caso di override in una classe derivata, chiude la connessione al database.
CloseAsync()

Chiude la connessione al database in modo asincrono.
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()

In caso di override in una classe derivata, restituisce una nuova istanza della classe del provider che implementa la DbBatch classe .
CreateDbCommand()

In caso di override in una classe derivata, crea e restituisce un oggetto DbCommand associato alla connessione corrente.
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
Dispose()

Rilascia tutte le risorse usate da Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da DbConnection e, facoltativamente, le risorse gestite.
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.

(Ereditato da Component)
DisposeAsync()

Elimina in modo asincrono l'oggetto connessione.
EnlistTransaction(Transaction)

Consente l'inserimento 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.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.

(Ereditato da MarshalByRefObject)
GetSchema()

Restituisce informazioni sullo schema per l'origine dati di questo oggetto DbConnection.
GetSchema(String)

Restituisce le informazioni di schema per l'origine dati dell'oggetto DbConnection usando la stringa specificata per il nome dello schema.
GetSchema(String, String[])

Restituisce le informazioni di schema per l'origine dati dell'oggetto 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. cancellationToken può facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona GetSchema() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da GetSchema() verranno passate mediante 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. cancellationToken può facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona GetSchema(String) e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da GetSchema(String) verranno passate mediante 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. cancellationToken può facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona GetSchema(String, String[]) e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da GetSchema(String, String[]) verranno passate mediante la proprietà Task Exception restituita.
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto 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 dell'oggetto Object corrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Genera l'evento StateChange.
Open()

In caso di override in una classe derivata, apre una connessione al database con le impostazioni specificate da ConnectionString.
OpenAsync()

Versione asincrona di Open(), che apre una connessione di database con le impostazioni specificate da 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ò facoltativamente essere rispettato.

L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da Open verranno passate mediante la proprietà Task Exception restituita.

Non richiamare altri metodi e proprietà dell'oggetto DbConnection finché l'attività restituita non viene completata.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. 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 cambia lo stato della connessione.

Implementazioni dell'interfaccia esplicita

IDbConnection.BeginTransaction()

Avvia una transazione di database.
IDbConnection.BeginTransaction(IsolationLevel)

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

Consente di configurare la modalità di esecuzione delle espressioni await per le attività restituite da un elemento disposable asincrono.

Si applica a

Vedi anche