Partage via


DbConnection Classe

Définition

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 : 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
Héritage
DbConnection
Héritage
Dérivé
Implémente

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

Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non managées.

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 DbConnection et libère éventuellement les ressources managées.

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 une chaîne qui représente l’objet actuel.

(Hérité de Object)
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.

S’applique à

Voir aussi