DbConnection Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.dll

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, IDisposable, System::Data::IDbConnection

public abstract class DbConnection : System.ComponentModel.Component, IDisposable, System.Data.IDbConnection

type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable

Public MustInherit Class DbConnection
Inherits Component
Implements IDbConnection, IDisposable

Ereditarietà

Object

MarshalByRefObject

Component

DbConnection

Derivato

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.OracleClient.OracleConnection

System.Data.SqlClient.SqlConnection

Implementazioni

IDisposable IDbConnection

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

Nome	Descrizione
DbConnection()	Inizializza una nuova istanza della classe DbConnection.

Proprietà

Nome	Descrizione
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 l'oggetto IContainer contenente l'oggetto 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 l'oggetto per l'oggetto DbProviderFactoryDbConnection.
DesignMode	Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (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 un valore che descrive lo stato della connessione.

Metodi

Nome	Descrizione
BeginDbTransaction(IsolationLevel)	Quando sottoposto a override in una classe derivata, avvia una transazione di database.
BeginTransaction()	Avvia una transazione di database.
BeginTransaction(IsolationLevel)	Avvia una transazione di database con il livello di isolamento specificato.
ChangeDatabase(String)	Quando sottoposto a override in una classe derivata, modifica il database corrente per una connessione aperta.
Close()	Quando sottoposto a override in una classe derivata, chiude la connessione al database.
CreateCommand()	Crea e restituisce un DbCommand oggetto associato alla connessione corrente.
CreateDbCommand()	Quando sottoposto a override in una classe derivata, crea e restituisce un DbCommand oggetto 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 da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, rilascia le risorse gestite. (Ereditato da Component)
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()	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 DbConnectionoggetto .
GetSchema(String, String[])	Restituisce informazioni sullo schema per l'origine dati di utilizzando DbConnection la stringa specificata per il nome dello schema e la matrice di stringhe specificata per i valori di restrizione.
GetSchema(String)	Restituisce informazioni sullo schema per l'origine dati di utilizzando DbConnection la stringa specificata per il nome dello schema.
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	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 corrente MarshalByRefObject . (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 da ConnectionString.
OpenAsync()	Versione asincrona di , che apre una connessione di Open()database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo OpenAsync(CancellationToken) virtuale 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 chiamata sincrona Open() 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 oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)

Eventi

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

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
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 DbCommand oggetto associato alla connessione corrente.

Vedi anche

• DbProviderFactories (ADO.NET)
• Panoramica di ADO.NET