DbConnection DbConnection DbConnection DbConnection Class

Définition

Représente une connexion à une base de données.Represents a connection to a 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
Héritage
Dérivé
Implémente

Notes pour les héritiers

Lorsque vous héritez DbConnectionde, vous devez substituer les membres suivants Close(): BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), et StateChange.When you inherit from DbConnection, you must override the following members: Close(), BeginDbTransaction(IsolationLevel), ChangeDatabase(String), CreateDbCommand(), Open(), and StateChange. Vous devez également fournir les propriétés suivantes: ConnectionString, Database, DataSource ServerVersion, et State.You must also provide the following properties: ConnectionString, Database, DataSource, ServerVersion, and State.

Constructeurs

DbConnection() DbConnection() DbConnection() DbConnection()

Initialise une nouvelle instance de la classe DbConnection.Initializes a new instance of the DbConnection class.

Propriétés

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

Obtient ou définit la chaîne utilisée pour ouvrir la connexion.Gets or sets the string used to open the connection.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Obtient la durée d'attente préalable à l'établissement d'une connexion avant que la tentative ne soit abandonnée et qu'une erreur ne soit générée.Gets the time to wait while establishing a connection before terminating the attempt and generating an error.

Container Container Container Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Database Database Database Database

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.Gets the name of the current database after a connection is opened, or the database name specified in the connection string before the connection is opened.

DataSource DataSource DataSource DataSource

Obtient le nom du serveur de base de données auquel se connecter.Gets the name of the database server to which to connect.

DbProviderFactory DbProviderFactory DbProviderFactory DbProviderFactory

Obtient le DbProviderFactory pour ce DbConnection.Gets the DbProviderFactory for this DbConnection.

DesignMode DesignMode DesignMode DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ServerVersion ServerVersion ServerVersion ServerVersion

Obtient une chaîne qui représente la version du serveur auquel l'objet est connecté.Gets a string that represents the version of the server to which the object is connected.

Site Site Site Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Obtient une chaîne qui décrit l'état de la connexion.Gets a string that describes the state of the connection.

Méthodes

BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel) BeginDbTransaction(IsolationLevel)

Commence une transaction de base de données.Starts a database transaction.

BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken) BeginDbTransactionAsync(IsolationLevel, CancellationToken)
BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

Commence une transaction de base de données.Starts a database transaction.

BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec le niveau d’isolement spécifié.Starts a database transaction with the specified isolation level.

BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken) BeginTransactionAsync(CancellationToken)
BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken) BeginTransactionAsync(IsolationLevel, CancellationToken)
ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

Modifie la base de données active d'une connexion ouverte.Changes the current database for an open connection.

ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken) ChangeDatabaseAsync(String, CancellationToken)
Close() Close() Close() Close()

Ferme la connexion à la base de données.Closes the connection to the database. C'est la méthode recommandée de fermeture d'une connexion ouverte.This is the preferred method of closing any open connection.

CloseAsync() CloseAsync() CloseAsync() CloseAsync()
CreateCommand() CreateCommand() CreateCommand() CreateCommand()

Crée et retourne un objet DbCommand associé à la connexion active.Creates and returns a DbCommand object associated with the current connection.

CreateDbCommand() CreateDbCommand() CreateDbCommand() CreateDbCommand()

Crée et retourne un objet DbCommand associé à la connexion active.Creates and returns a DbCommand object associated with the current connection.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()
EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

S'inscrit dans la transaction spécifiée.Enlists in the specified transaction.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSchema() GetSchema() GetSchema() GetSchema()

Retourne les informations de schéma pour la source de données de ce DbConnection.Returns schema information for the data source of this DbConnection.

GetSchema(String) GetSchema(String) GetSchema(String) 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.Returns schema information for the data source of this DbConnection using the specified string for the schema name.

GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[]) 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.Returns schema information for the data source of this DbConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs) OnStateChange(StateChangeEventArgs)

Déclenche l'événement StateChange.Raises the StateChange event.

Open() Open() Open() Open()

Ouvre une connexion à une base de données avec les paramètres spécifiés par ConnectionString.Opens a database connection with the settings specified by the ConnectionString.

OpenAsync() OpenAsync() OpenAsync() OpenAsync()

Version asynchrone de Open(), qui ouvre une connexion de base de données avec les paramètres spécifiés par ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Cette méthode appelle la méthode virtuelle OpenAsync(CancellationToken) avec CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken) OpenAsync(CancellationToken) OpenAsync(CancellationToken) OpenAsync(CancellationToken)

Il s'agit de la version asynchrone de Open().This is the asynchronous version of Open(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée.Providers should override with an appropriate implementation. Le jeton d'annulation peut éventuellement être respecté.The cancellation token can optionally be honored.

L'implémentation par défaut appelle l'appel de méthode Open() synchrone et retourne une tâche terminée.The default implementation invokes the synchronous Open() call and returns a completed task. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Les exceptions levées par Open sont communiquées via la propriété d'exception de tâche retournée.Exceptions thrown by Open will be communicated via the returned Task Exception property.

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.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

ToString() ToString() ToString() ToString()

Retourne un String contenant le nom du Component, s’il en existe un.Returns a String containing the name of the Component, if any. Cette méthode ne doit pas être remplacée.This method should not be overridden.

(Inherited from Component)

Événements

Disposed Disposed Disposed Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
StateChange StateChange StateChange StateChange

Se produit lorsque l'état de l'événement change.Occurs when the state of the event changes.

Implémentations d’interfaces explicites

IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction()

Commence une transaction de base de données.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec la valeur de champ IsolationLevel spécifiée.Begins a database transaction with the specified IsolationLevel value.

IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand()

Crée et retourne un objet DbCommand associé à la connexion actuelle.Creates and returns a DbCommand object that is associated with the current connection.

S’applique à

Voir aussi