OleDbConnection Classe

Définition

Espace de noms:: System.Data.OleDb

Assembly:: System.Data.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une connexion ouverte à une source de données.

public ref class OleDbConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable

public sealed class OleDbConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection

public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable

type OleDbConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable

type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable

Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Héritage: Object

MarshalByRefObject

Component
OleDbConnection

Héritage: Object

MarshalByRefObject

Component

DbConnection
OleDbConnection

Implémente: IDbConnection ICloneable IDisposable

Exemples

L’exemple suivant crée un OleDbCommand et un OleDbConnection. Il OleDbConnection est ouvert et défini comme pour Connection le OleDbCommand. L’exemple appelle ExecuteNonQuery puis ferme la connexion. Pour ce faire, ExecuteNonQuery est passé un chaîne de connexion et une chaîne de requête qui est une instruction SQL INSERT.

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 OleDbConnection objet 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, certaines méthodes ou propriétés d’un OleDbConnection objet peuvent ne pas être disponibles.

Lorsque vous créez une instance de OleDbConnection, toutes les propriétés sont définies sur leurs valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le OleDbConnection constructeur.

Vous pouvez ouvrir plusieurs DataReader sur un seul OleDbConnection. Si le fournisseur OLE DB que vous utilisez ne prend pas en charge plusieurs DataReader sur une seule connexion, le fournisseur ouvre implicitement une connexion supplémentaire pour chacun d’eux.

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

Note

Pour déployer des applications hautes performances, vous devez utiliser le regroupement de connexions. Lorsque vous utilisez le .NET Framework Fournisseur de données pour OLE DB, vous n’avez pas besoin d’activer le regroupement de connexions, car le fournisseur gère cette opération automatiquement. Pour plus d’informations sur l’utilisation du regroupement de connexions avec .NET Framework Fournisseur de données pour OLE DB, consultez OLE DB, ODBC et Oracle Connection Pooling.

Si un > /, le peut être fermé. Toutefois, l’utilisateur peut 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 disposent d’une autorisation suffisante pour le code en définissant des exigences de sécurité déclaratives ou impératives. OleDbConnection effectue des demandes de sécurité à l’aide de l’objet OleDbPermission . Les utilisateurs peuvent vérifier que leur code dispose d’autorisations suffisantes à l’aide de l’objet OleDbPermissionAttribute . Les utilisateurs et les administrateurs peuvent également utiliser le Caspol.exe (outil de stratégie de sécurité d’accès au code) 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 Code Access Security and ADO.NET.

Pour plus d’informations sur la gestion des messages d’avertissement et d’information du serveur de données, consultez Événements de connexion.

Note

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. Seules les propriétés pouvant être passées dans la chaîne de connexion du fournisseur OLE DB sont prises en charge.

Constructeurs

Nom	Description
OleDbConnection()	Initialise une nouvelle instance de la classe OleDbConnection.
OleDbConnection(String)	Initialise une nouvelle instance de la OleDbConnection classe avec la chaîne de connexion spécifiée.

Propriétés

Nom	Description
CanRaiseEvents	Obtient une valeur indiquant si le composant peut déclencher un événement. (Hérité de Component)
ConnectionString	Obtient ou définit la chaîne utilisée pour ouvrir une base de données.
ConnectionTimeout	Obtient le délai d’attente (en secondes) lors de la tentative d’établissement d’une connexion avant de terminer la tentative et de générer une erreur.
Container	Obtient le IContainer fichier qui contient le Component. (Hérité de Component)
Database	Obtient le nom de la base de données active ou de la base de données à utiliser après l’ouverture d’une connexion.
DataSource	Obtient le nom du serveur ou le nom de fichier de la source de données.
DbProviderFactory	Obtient la DbProviderFactory valeur de ce DbConnection. (Hérité de DbConnection)
DesignMode	Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
Events	Obtient la liste des gestionnaires d’événements qui sont attachés à ce Component. (Hérité de Component)
Provider	Obtient le nom du fournisseur OLE DB spécifié dans la clause « Provider= » de l’chaîne de connexion.
ServerVersion	Obtient une chaîne qui contient la version du serveur auquel le client est connecté.
Site	Obtient ou définit le ISite de Component. (Hérité de Component)
State	Obtient l’état actuel de la connexion.

Méthodes

Nom	Description
BeginDbTransaction(IsolationLevel)	En cas de substitution dans une classe dérivée, démarre une transaction de base de données. (Hérité de DbConnection)
BeginTransaction()	Démarre une transaction de base de données avec la valeur actuelle IsolationLevel .
BeginTransaction(IsolationLevel)	Démarre une transaction de base de données avec le niveau d’isolation spécifié.
ChangeDatabase(String)	Modifie la base de données active pour une base de données ouverte OleDbConnection.
Close()	Ferme la connexion à la source de données.
CreateCommand()	Crée et retourne un OleDbCommand objet associé au OleDbConnection.
CreateDbCommand()	En cas de substitution dans une classe dérivée, crée et retourne un DbCommand objet associé à la connexion actuelle. (Hérité de DbConnection)
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 les Component ressources gérées et libère éventuellement les ressources managées. (Hérité de Component)
EnlistDistributedTransaction(ITransaction)	Inscrit dans la transaction spécifiée en tant que transaction distribuée.
EnlistTransaction(Transaction)	Inscrit dans la transaction spécifiée en tant que transaction distribué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()	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)
GetOleDbSchemaTable(Guid, Object[])	Retourne des informations de schéma à partir d’une source de données, comme indiqué par un GUID, et après avoir appliqué les restrictions spécifiées.
GetSchema()	Retourne des informations de schéma pour la source de données de ce OleDbConnection.
GetSchema(String, String[])	Retourne des informations de schéma pour la source de données de cette OleDbConnection méthode à 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.
GetSchema(String)	Retourne des informations de schéma pour la source de données de cette OleDbConnection méthode à l’aide de la chaîne spécifiée pour le nom du schéma.
GetService(Type)	Retourne un objet qui représente un service fourni par le Component ou par son Container. (Hérité de Component)
GetType()	Obtient la Type de l’instance actuelle. (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. (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 actuel MarshalByRefObject . (Hérité de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Déclenche l’événement StateChange. (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.
OpenAsync()	Version asynchrone de , qui ouvre une connexion de base de Open()données avec les paramètres spécifiés par le ConnectionString. Cette méthode appelle la méthode OpenAsync(CancellationToken) virtuelle avec CancellationToken.None. (Hérité de DbConnection)
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 synchrone Open() 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. (Hérité de DbConnection)
ReleaseObjectPool()	Indique que le OleDbConnection pool d’objets peut être libéré lorsque la dernière connexion sous-jacente est publiée.
ResetState()	Met à jour la State propriété de l’objet OleDbConnection .
ToString()	Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de Component)

Événements

Nom	Description
Disposed	Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)
InfoMessage	Se produit lorsque le fournisseur envoie un avertissement ou un message d’information.
StateChange	Se produit lorsque l’état de la connexion change.
StateChange	Se produit lorsque l’état de la connexion change. (Hérité de DbConnection)

Implémentations d’interfaces explicites

Nom	Description
ICloneable.Clone()	Pour obtenir une description de ce membre, consultez Clone().
IDbConnection.BeginTransaction()	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Commence une transaction de base de données.
IDbConnection.BeginTransaction()	Commence une transaction de base de données. (Hérité de DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Commence une transaction de base de données avec le niveau d’isolation spécifié.
IDbConnection.BeginTransaction(IsolationLevel)	Commence une transaction de base de données avec le niveau d’isolation spécifié. (Hérité de DbConnection)
IDbConnection.CreateCommand()	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Crée et retourne un objet de commande associé à la connexion.
IDbConnection.CreateCommand()	Crée et retourne un DbCommand objet associé à la connexion actuelle. (Hérité de DbConnection)

S’applique à

Voir aussi

Connexion à des sources de données

Commentaires

Cette page a-t-elle été utile ?