OleDbConnection Classe

Définition

Représente une connexion ouverte à une source de données.Represents an open connection to a data source.

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable
Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable
Héritage
Implémente

Exemples

L’exemple suivant crée un OleDbCommand et un OleDbConnection.The following example creates an OleDbCommand and an OleDbConnection. Le OleDbConnection est ouvert et défini comme Connection pour le OleDbCommand.The OleDbConnection is opened and set as the Connection for the OleDbCommand. L’exemple appelle ensuite ExecuteNonQuery et ferme la connexion.The example then calls ExecuteNonQuery and closes the connection. Pour ce faire, ExecuteNonQuery reçoit une chaîne de connexion et une chaîne de requête qui est une instruction SQL INSERT.To accomplish this, ExecuteNonQuery is passed a connection string and a query string that is an SQL INSERT statement.

public void InsertRow(string connectionString, string insertSQL)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OleDbCommand command = new OleDbCommand(insertSQL);

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}
Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OleDbConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OleDbCommand(insertSQL)

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Remarques

Un objet OleDbConnection représente une connexion unique à une source de données.An OleDbConnection object represents a unique connection to a data source. Avec un système de base de données client/serveur, il est équivalent à une connexion réseau au serveur.With a client/server database system, it is equivalent to a network connection to the server. Selon les fonctionnalités prises en charge par le fournisseur de OLE DB natif, certaines méthodes ou propriétés d’un objet OleDbConnection peuvent ne pas être disponibles.Depending on the functionality supported by the native OLE DB provider, some methods or properties of an OleDbConnection object may not be available.

Lorsque vous créez une instance de OleDbConnection, toutes les propriétés sont définies sur leurs valeurs initiales.When you create an instance of OleDbConnection, all properties are set to their initial values. Pour obtenir la liste de ces valeurs, consultez le constructeur OleDbConnection.For a list of these values, see the OleDbConnection constructor.

Vous pouvez ouvrir plusieurs DataReaders sur une seule OleDbConnection.You can open more than one DataReader on a single OleDbConnection. Si le fournisseur de OLE DB que vous utilisez ne prend pas en charge plus d’un DataReader sur une seule connexion, le fournisseur ouvre implicitement une connexion supplémentaire pour chaque.If the OLE DB provider you use does not support more than one DataReader on a single connection, the provider implicitly opens an additional connection for each.

Si le OleDbConnection est hors de portée, il n’est pas fermé.If the OleDbConnection goes out of scope, it is not closed. Par conséquent, vous devez fermer explicitement la connexion en appelant Close ou dispose, ou en utilisant l’objet OleDbConnection dans une instruction Using.Therefore, you must explicitly close the connection by calling Close or Dispose, or by using the OleDbConnection object within a Using statement.

Notes

Pour déployer des applications à hautes performances, vous devez utiliser le regroupement de connexions.To deploy high-performance applications, you must use connection pooling. Lorsque vous utilisez le Fournisseur de données .NET Framework pour OLE DB, il n’est pas nécessaire d’activer le regroupement de connexions, car le fournisseur le gère automatiquement.When you use the .NET Framework Data Provider for OLE DB, you do not have to enable connection pooling because the provider manages this automatically. Pour plus d’informations sur l’utilisation du regroupement de connexions avec le Fournisseur de données .NET Framework pour OLE DB, consultez OLE DB, ODBC et regroupement de connexions Oracle.For more information about how to use connection pooling with the .NET Framework Data Provider for OLE DB, see OLE DB, ODBC, and Oracle Connection Pooling.

Si une OleDbException irrécupérable (par exemple, un niveau de gravité SQL Server supérieur ou égal à 20) est générée par la méthode exécutant un OleDbCommand, le OleDbConnection peut être fermé.If a fatal OleDbException (for example, a SQL Server severity level of 20 or greater) is generated by the method executing an OleDbCommand, the OleDbConnection might be closed. L'utilisateur peut toutefois rouvrir la connexion et continuer.However, the user can reopen the connection and continue.

Une application qui crée une instance de l’objet OleDbConnection peut demander à tous les appelants directs et indirects d’avoir des autorisations suffisantes pour le code en définissant des demandes de sécurité déclaratives ou impératives.An application that creates an instance of the OleDbConnection object can require all direct and indirect callers to have sufficient permission to the code by setting declarative or imperative security demands. OleDbConnection fait des demandes de sécurité à l’aide de l’objet OleDbPermission.OleDbConnection makes security demands using the OleDbPermission object. Les utilisateurs peuvent vérifier que leur code dispose des autorisations suffisantes à l’aide de l’objet OleDbPermissionAttribute.Users can verify that their code has sufficient permissions by using the OleDbPermissionAttribute object. Les utilisateurs et les administrateurs peuvent également utiliser Caspol. exe (outil de stratégie de sécurité d’accès du code) pour modifier la stratégie de sécurité au niveau de l’ordinateur, de l’utilisateur et de l’entreprise.Users and administrators can also use the Caspol.exe (Code Access Security Policy Tool) to modify security policy at the computer, user, and enterprise levels. Pour plus d'informations, consultez Code Access Security and ADO.NET.For more information, see Code Access Security and ADO.NET.

Pour plus d’informations sur la gestion des messages d’avertissement et d’information à partir du serveur de données, consultez événements de connexion.For more information about handling warning and informational messages from the data server, see Connection Events.

Notes

L’objet OleDbConnection ne prend pas en charge la définition ou la récupération de propriétés dynamiques spécifiques à un fournisseur OLE DB.The OleDbConnection object does not support setting or retrieving dynamic properties specific to an OLE DB provider. Seules les propriétés pouvant être passées dans la chaîne de connexion du fournisseur OLE DB sont prises en charge.Only properties that can be passed in the connection string for the OLE DB provider are supported.

Constructeurs

OleDbConnection()

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

OleDbConnection(String)

Initialise une nouvelle instance de la classe OleDbConnection avec la chaîne de connexion spécifiée.Initializes a new instance of the OleDbConnection class with the specified connection string.

Propriétés

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.

(Hérité de Component)
ConnectionString

Obtient ou définit la chaîne utilisée pour ouvrir une base de données.Gets or sets the string used to open a database.

ConnectionTimeout

Obtient le délai d’attente (en secondes) lors de la tentative d’établissement d’une connexion avant de mettre fin à la tentative et de générer une erreur.Gets the time to wait (in seconds) while trying to establish a connection before terminating the attempt and generating an error.

Container

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

(Hérité de Component)
Database

Obtient le nom de la base de données active ou de la base de données à utiliser une fois la connexion ouverte.Gets the name of the current database or the database to be used after a connection is opened.

DataSource

Obtient le nom de serveur ou le nom de fichier de la source de données.Gets the server name or file name of the data source.

DbProviderFactory

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

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

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

(Hérité de Component)
Provider

Obtient le nom du fournisseur OLE DB tel qu'il est spécifié dans la clause "Provider=" de la chaîne de connexion.Gets the name of the OLE DB provider specified in the "Provider= " clause of the connection string.

ServerVersion

Obtient une chaîne qui contient la version du serveur auquel le client est connecté.Gets a string that contains the version of the server to which the client is connected.

Site

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

(Hérité de Component)
State

Obtient l’état actuel de la connexion.Gets the current state of the connection.

Méthodes

BeginDbTransaction(IsolationLevel)

En cas de substitution dans une classe dérivée, démarre une transaction de base de données.When overridden in a derived class, starts a database transaction.

(Hérité de DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Démarre de manière asynchrone une transaction de base de données.Asynchronously starts a database transaction.

(Hérité de DbConnection)
BeginTransaction()

Commence une transaction de base de données avec la valeur IsolationLevel actuelle.Starts a database transaction with the current IsolationLevel value.

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)

Commence de manière asynchrone une transaction de base de données.Asynchronously begins a database transaction.

(Hérité de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)

Commence de manière asynchrone une transaction de base de données.Asynchronously begins a database transaction.

(Hérité de DbConnection)
ChangeDatabase(String)

Modifie la base de données actuelle d'une connexion OleDbConnection établie.Changes the current database for an open OleDbConnection.

ChangeDatabaseAsync(String, CancellationToken)

Change de manière asynchrone la base de données actuelle pour une connexion ouverte.Asynchronously changes the current database for an open connection.

(Hérité de DbConnection)
Close()

Ferme la connexion à la source de données.Closes the connection to the data source.

CloseAsync()

Ferme de manière asynchrone la connexion à la base de données.Asynchronously closes the connection to the database.

(Hérité de DbConnection)
CreateCommand()

Crée et retourne un objet OleDbCommand associé à OleDbConnection.Creates and returns an OleDbCommand object associated with the OleDbConnection.

CreateDbCommand()

En cas de substitution dans une classe dérivée, crée et retourne un objet DbCommand associé à la connexion active.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

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

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the 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.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Hérité de Component)
DisposeAsync()

Supprime de manière asynchrone l’objet de connexion.Asynchronously diposes the connection object.

(Hérité de DbConnection)
EnlistDistributedTransaction(ITransaction)

S’inscrit dans la transaction spécifiée en tant que transaction distribuée.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction)

S’inscrit dans la transaction spécifiée en tant que transaction distribuée.Enlists in the specified transaction as a distributed transaction.

Equals(Object)

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

(Hérité de Object)
GetHashCode()

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

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

(Hérité de MarshalByRefObject)
GetOleDbSchemaTable(Guid, Object[])

Retourne les informations de schéma à partir d'une source de données de la manière indiquée par un GUID et après l'application des restrictions spécifiées.Returns schema information from a data source as indicated by a GUID, and after it applies the specified restrictions.

GetSchema()

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

GetSchema(String)

Retourne des informations de schéma pour la source de données de ce OleDbConnection à l’aide de la chaîne spécifiée pour le nom de schéma.Returns schema information for the data source of this OleDbConnection using the specified string for the schema name.

GetSchema(String, String[])

Retourne les informations de schéma pour la source de données de ce OleDbConnection à 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 OleDbConnection using the specified string for the schema name and the specified string array for the restriction values.

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.

(Hérité de Component)
GetType()

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

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

(Hérité de MarshalByRefObject)
MemberwiseClone()

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

(Hérité de Object)
MemberwiseClone(Boolean)

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

(Hérité de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

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

(Hérité de DbConnection)
Open()

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

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.

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

(Hérité de DbConnection)
ReleaseObjectPool()

Indique que le pool d'objet OleDbConnection peut être libéré lorsque la dernière connexion sous-jacente est libérée.Indicates that the OleDbConnection object pool can be released when the last underlying connection is released.

ResetState()

Met à jour la propriété State de l'objet OleDbConnection.Updates the State property of the OleDbConnection object.

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.

(Hérité de Component)

Événements

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.

(Hérité de Component)
InfoMessage

Se produit lorsque le fournisseur envoie un avertissement ou un message d'information.Occurs when the provider sends a warning or an informational message.

StateChange

Implémentations d’interfaces explicites

ICloneable.Clone()

Pour obtenir une description de ce membre, consultez Clone().For a description of this member, see Clone().

IDbConnection.BeginTransaction()

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

IDbConnection.BeginTransaction(IsolationLevel)

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

IDbConnection.CreateCommand()

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

S’applique à

Voir aussi