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 indiquant 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 temps d’attente (en secondes) lors de l’établissement d’une connexion avant de terminer la tentative et de générer une erreur.
Container	Obtient le IContainer qui contient le 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 l’ouverture d’une connexion, ou le nom de la base de données spécifié dans la chaîne de connexion avant l’ouverture de la connexion.
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 la DbProviderFactory pour cette DbConnection.
DesignMode	Obtient une valeur qui indique si le Component est actuellement en mode création. (Hérité de Component)
Events	Obtient la liste des gestionnaires d’événements qui sont attachés à cette 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 la ISite du 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 façon asynchrone une transaction de base de données.
BeginTransaction()	Démarre une transaction de base de données.
BeginTransaction(IsolationLevel)	Démarre une transaction de base de données avec le niveau d’isolation spécifié.
BeginTransactionAsync(CancellationToken)	Commence de façon asynchrone une transaction de base de données.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Commence de façon 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 active pour une connexion ouverte.
ChangeDatabaseAsync(String, CancellationToken)	Modifie de façon asynchrone la base de données active 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 façon 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 actuelle.
CreateDbBatch()	En cas de substitution dans une classe dérivée, retourne une nouvelle instance de la classe du fournisseur qui implémente la classe DbBatch.
CreateDbCommand()	En cas de substitution dans une classe dérivée, crée et retourne un objet DbCommand associé à la connexion actuelle.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Libère les ressources non managées utilisées par le Component et libère éventuellement les ressources managées. (Hérité de Component)
DisposeAsync()	Dipose de façon asynchrone l’objet de connexion.
EnlistTransaction(Transaction)	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()	Sert 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 actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetSchema()	Retourne des informations de schéma pour la source de données de cette DbConnection.
GetSchema(String)	Retourne des informations de schéma pour la source de données de cette DbConnection à l’aide de la chaîne spécifiée pour le nom de schéma.
GetSchema(String, String[])	Retourne des informations de schéma pour la source de données de cette DbConnection à l’aide de la chaîne spécifiée pour le nom du 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 remplacer par une implémentation appropriée. Le cancellationToken peut éventuellement être honoré. L’implémentation par défaut appelle l’appel de GetSchema() synchrone et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée s’il a réussi un cancellationTokendéjà annulé. Les exceptions levées par GetSchema() sont communiquées via la propriété Exception de tâche retournée.
GetSchemaAsync(String, CancellationToken)	Il s’agit de la version asynchrone de GetSchema(String). Les fournisseurs doivent remplacer par une implémentation appropriée. Le cancellationToken peut éventuellement être honoré. L’implémentation par défaut appelle l’appel de GetSchema(String) synchrone et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée s’il a réussi un cancellationTokendéjà annulé. Les exceptions levées par GetSchema(String) sont communiquées via la propriété Exception de tâche retournée.
GetSchemaAsync(String, String[], CancellationToken)	Il s’agit de la version asynchrone de GetSchema(String, String[]). Les fournisseurs doivent remplacer par une implémentation appropriée. Le cancellationToken peut éventuellement être honoré. L’implémentation par défaut appelle l’appel de GetSchema(String, String[]) synchrone et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée s’il a réussi un cancellationTokendéjà annulé. Les exceptions levées par GetSchema(String, String[]) sont communiquées via la propriété Exception de tâche retournée.
GetService(Type)	Renvoie un objet qui représente un service fourni par l'Component ou par son Container. (Hérité de Component)
GetType()	Obtient la 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 Objectactuel. (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 le ConnectionString.
OpenAsync()	Version asynchrone de Open(), qui ouvre une connexion de base de données avec les paramètres spécifiés par le 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 remplacer par une implémentation appropriée. Le jeton d’annulation peut éventuellement être honoré. L’implémentation par défaut appelle l’appel de Open() synchrone et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée si elle a passé une annulation d’annulationToken. Les exceptions levées par Open seront communiquées via la propriété Exception de tâche retournée. N’appelez pas d’autres méthodes et propriétés de l’objet DbConnection tant que la tâche retournée n’est pas terminée.
ToString()	Retourne un String contenant le nom du Component, le cas échéant. 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 lorsque 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’isolation 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 jetable asynchrone sont effectuées.

Voir aussi

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