DbConnection Classe

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbConnection.cs

Définit le comportement principal des connexions de base de données et fournit une classe de base pour les connexions spécifiques à la base de données.

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

Héritage

Object

MarshalByRefObject

Component

DbConnection

Dérivé

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.SqlClient.SqlConnection

Implémente

IDisposable IDbConnection IAsyncDisposable

Notes pour les responsables de l’implémentation

Lorsque vous héritez de DbConnection, vous devez remplacer les membres suivants : Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), , Open()et StateChange. Vous devez également fournir les propriétés suivantes : ConnectionString, Database, DataSource, ServerVersionet State.

Constructeurs

DbConnection()

Initialise une nouvelle instance de la classe DbConnection.

Propriétés

CanCreateBatch	Obtient une valeur qui indique si cette instance DbConnection prend en charge la classe DbBatch.
CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
ConnectionString	En cas de substitution dans une classe dérivée, obtient ou définit la chaîne utilisée pour ouvrir la connexion.
ConnectionTimeout	Obtient le délai d’attente (en secondes) lors de l’établissement d’une connexion avant de mettre fin à la tentative et de générer une erreur.
Container	Obtient le IContainer qui contient la Component. (Hérité de Component)
Database	En cas de substitution dans une classe dérivée, obtient le nom de la base de données active après avoir ouvert une connexion, ou le nom de la base de données spécifié dans la chaîne de connexion avant que la connexion ne soit ouverte.
DataSource	En cas de substitution dans une classe dérivée, obtient le nom du serveur de base de données auquel se connecter.
DbProviderFactory	Obtient le DbProviderFactory pour ce DbConnection.
DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
ServerVersion	En cas de substitution dans une classe dérivée, obtient une chaîne qui représente la version du serveur auquel l'objet est connecté.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
State	Obtient une chaîne qui décrit l'état de la connexion.

Méthodes

BeginDbTransaction(IsolationLevel)	En cas de substitution dans une classe dérivée, démarre une transaction de base de données.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Démarre de manière asynchrone une transaction de base de données.
BeginTransaction()	Commence une transaction de base de données.
BeginTransaction(IsolationLevel)	Commence une transaction de base de données avec le niveau d’isolement spécifié.
BeginTransactionAsync(CancellationToken)	Commence de manière asynchrone une transaction de base de données.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Commence de manière asynchrone une transaction de base de données.
ChangeDatabase(String)	En cas de substitution dans une classe dérivée, modifie la base de données actuelle pour une connexion ouverte.
ChangeDatabaseAsync(String, CancellationToken)	Change de manière asynchrone la base de données actuelle pour une connexion ouverte.
Close()	En cas de substitution dans une classe dérivée, ferme la connexion à la base de données.
CloseAsync()	Ferme de manière asynchrone la connexion à la base de données.
CreateBatch()	Retourne une nouvelle instance de la classe du fournisseur qui implémente la classe DbBatch.
CreateCommand()	Crée et retourne un objet DbCommand associé à la connexion active.
CreateDbBatch()	En cas de substitution dans une classe dérivée, retourne une nouvelle instance de la classe du fournisseur qui implémente la DbBatch classe .
CreateDbCommand()	En cas de substitution dans une classe dérivée, crée et retourne un objet DbCommand associé à la connexion active.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component)
DisposeAsync()	Supprime de manière asynchrone l’objet de connexion.
EnlistTransaction(Transaction)	S'inscrit dans la transaction spécifiée.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetSchema()	Retourne les informations de schéma pour la source de données de ce DbConnection.
GetSchema(String)	Retourne des informations de schéma pour la source de données de ce DbConnection à l’aide de la chaîne spécifiée pour le nom de schéma.
GetSchema(String, String[])	Retourne les informations de schéma pour la source de données de ce DbConnection à l’aide de la chaîne spécifiée pour le nom de schéma et du tableau de chaînes spécifié pour les valeurs de restriction.
GetSchemaAsync(CancellationToken)	Il s'agit d’une version asynchrone de GetSchema(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le cancellationToken peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par GetSchema() sont communiquées via la propriété d'exception de tâche retournée.
GetSchemaAsync(String, CancellationToken)	Il s'agit de la version asynchrone de GetSchema(String). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le cancellationToken peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema(String) synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par GetSchema(String) sont communiquées via la propriété d'exception de tâche retournée.
GetSchemaAsync(String, String[], CancellationToken)	Il s'agit de la version asynchrone de GetSchema(String, String[]). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le cancellationToken peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema(String, String[]) synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par GetSchema(String, String[]) sont communiquées via la propriété d'exception de tâche retournée.
GetService(Type)	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Déclenche l’événement StateChange.
Open()	En cas de substitution dans une classe dérivée, ouvre une connexion de base de données avec les paramètres spécifiés par ConnectionString.
OpenAsync()	Version asynchrone de Open(), qui ouvre une connexion de base de données avec les paramètres spécifiés par ConnectionString. Cette méthode appelle la méthode virtuelle OpenAsync(CancellationToken) avec CancellationToken.None.
OpenAsync(CancellationToken)	Il s'agit de la version asynchrone de Open(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le jeton d'annulation peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode Open() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par Open sont communiquées via la propriété d'exception de tâche retournée. N'appelle pas d'autres méthodes et propriétés de l'objet DbConnection jusqu'à ce que la tâche retournée soit terminée.
ToString()	Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component)

Événements

Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)
StateChange	Se produit quand l’état de la connexion change.

Implémentations d’interfaces explicites

IDbConnection.BeginTransaction()	Commence une transaction de base de données.
IDbConnection.BeginTransaction(IsolationLevel)	Commence une transaction de base de données avec le niveau d’isolement spécifié.
IDbConnection.CreateCommand()	Crée et retourne un objet DbCommand associé à la connexion actuelle.

Méthodes d’extension

ConfigureAwait(IAsyncDisposable, Boolean)

Configure la façon dont les attentes sur les tâches retournées à partir d’un élément supprimable asynchrone sont effectuées.

Voir aussi

• DbProviderFactories (ADO.NET)
• Vue d'ensemble d’ADO.NET