OleDbConnection, classe

Un objet OleDbConnection représente une connexion unique à une source de données. Avec un système de base de données client/serveur, il équivaut à une connexion réseau au serveur. Selon les fonctionnalités prises en charge par le fournisseur OLE DB natif, il se peut que certaines méthodes ou propriétés d'un objet OleDbConnection ne soient pas disponibles.

Lorsque vous créez une instance de OleDbConnection, les valeurs initiales sont affectées à toutes les propriétés. Pour obtenir la liste de ces valeurs, consultez le constructeur OleDbConnection.

Si OleDbConnection est hors de portée, il n'est pas fermé. Par conséquent, vous devez fermer explicitement la connexion en appelant Close ou Dispose, ou en utilisant l'objet OleDbConnection dans une instruction Using.

Remarque

Pour déployer des applications hautes performances, vous devez utiliser le regroupement de connexion. Si vous utilisez le fournisseur de données .NET Framework pour OLE DB, vous ne devez pas activer le regroupement de connexion, car le fournisseur le gère automatiquement. Pour plus d'informations sur l'utilisation du regroupement de connexion avec le fournisseur de données .NET Framework pour OLE DB, consultez Présentation du regroupement de connexions.

Si un OleDbException irrécupérable (par exemple, un niveau de gravité SQL Server égal ou supérieur à 20) est généré par la méthode exécutant un OleDbCommand, OleDbConnection, la connexion risque de se fermer. L'utilisateur peut toutefois rouvrir la connexion et continuer.

Une application qui crée une instance de l'objet OleDbConnection peut exiger que tous les appelants directs et indirects possèdent l'autorisation suffisante pour le code en définissant des demandes de sécurité déclaratives ou impératives. OleDbConnection crée des demandes de sécurité à l'aide de l'objet OleDbPermission. Les utilisateurs peuvent vérifier que leur code possède les autorisations suffisantes à l'aide de l'objet OleDbPermissionAttribute. Les utilisateurs et administrateurs peuvent également utiliser Outil Code Access Security Policy Tool (Caspol.exe) pour modifier la stratégie de sécurité au niveau de l'ordinateur, de l'utilisateur et de l'entreprise. Pour plus d'informations, consultez Sécurité d'accès du code et ADO.NET.

Pour plus d'informations sur la gestion des messages d'avertissement et d'information à partir du serveur de données, consultez Utilisation des événements Connection.

Remarque
L'objet OleDbConnection ne prend pas en charge la définition ou la récupération de propriétés dynamiques spécifiques d'un fournisseur OLE DB. Seules les propriétés pouvant être passées dans la chaîne de connexion du fournisseur OLE DB sont prises en charge.

L'exemple suivant crée un OleDbCommand et un OleDbConnection. OleDbConnection est ouvert et défini en tant que Connection pour OleDbCommand. L'exemple appelle ensuite ExecuteNonQuery et ferme la connexion. Pour effectuer cette opération, une chaîne de connexion et une chaîne de requête qui est une instruction SQL INSERT sont passées à ExecuteNonQuery.

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.
    }

using System;
using System.Data;
using System.Data.OleDb;

class Class1
{
    static void Main()
    {
    }

    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.
        }

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework