OleDbConnection Classe

Définition

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

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable
public ref class OleDbConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable
public sealed class OleDbConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
type OleDbConnection = class
    inherit DbConnection
    interface IDbConnection
    interface IDisposable
    interface ICloneable
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 DbConnection
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
Héritage
OleDbConnection
Héritage
Héritage
Implémente

Exemples

L’exemple suivant crée un OleDbCommand et un OleDbConnection . Le OleDbConnection est ouvert et défini en tant que Connection pour le OleDbCommand . L’exemple appelle ensuite ExecuteNonQuery et ferme la connexion. pour ce faire, reçoit ExecuteNonQuery une 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 est équivalent à une connexion réseau au serveur. Selon les fonctionnalités prises en charge par le fournisseur de 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 DataReaders sur un seul 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.

Si le 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' OleDbConnection objet dans une Using instruction.

Notes

Pour déployer des applications à hautes performances, vous devez utiliser le regroupement de connexions. 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. 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.

si une erreur irrécupérable OleDbException (par exemple, un niveau de gravité de SQL Server de 20 ou supérieur) est générée par la méthode exécutant un OleDbCommand , le OleDbConnection peut être fermé. L'utilisateur peut toutefois rouvrir la connexion et continuer.

Une application qui crée une instance de l' OleDbConnection objet peut exiger que tous les appelants directs et indirects disposent d’autorisations suffisantes pour le code en définissant des demandes de sécurité déclaratives ou impératives. OleDbConnection fait des demandes de sécurité à l’aide de l' OleDbPermission objet. Les utilisateurs peuvent vérifier que leur code dispose des autorisations suffisantes à l’aide de l' OleDbPermissionAttribute objet. Les utilisateurs et les administrateurs peuvent également utiliser le Caspol.exe (outil 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. 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 à partir du serveur de données, consultez événements de connexion.

Notes

L' OleDbConnection objet ne prend pas en charge la définition ou la récupération de propriétés dynamiques spécifiques à un fournisseur de 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

OleDbConnection()

Initialise une nouvelle instance de la classe OleDbConnection.

OleDbConnection(String)

Initialise une nouvelle instance de la classe OleDbConnection avec la chaîne de connexion spécifiée.

Propriétés

CanCreateBatch (Hérité de DbConnection)
CanRaiseEvents

Obtient une valeur qui indique 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 mettre fin à la tentative et de générer une erreur.

Container

Obtient le IContainer qui contient la 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.

DataSource

Obtient le nom de serveur ou le nom de fichier de la source de données.

DbProviderFactory

Obtient le DbProviderFactory pour ce DbConnection.

(Hérité de DbConnection)
DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d'événements attachés à ce 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.

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

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)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)

Démarre de manière asynchrone une transaction de base de données.

(Hérité de DbConnection)
BeginTransaction()

Commence une transaction de base de données avec la valeur IsolationLevel actuelle.

BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec le niveau d’isolement spécifié.

BeginTransactionAsync(CancellationToken)

Commence de manière asynchrone une transaction de base de données.

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

Commence de manière asynchrone une transaction de base de données.

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

Modifie la base de données actuelle d'une connexion OleDbConnection établie.

ChangeDatabaseAsync(String, CancellationToken)

Change de manière asynchrone la base de données actuelle pour une connexion ouverte.

(Hérité de DbConnection)
Close()

Ferme la connexion à la source de données.

CloseAsync()

Ferme de manière asynchrone la connexion à la base de données.

(Hérité de DbConnection)
CreateBatch() (Hérité de DbConnection)
CreateCommand()

Crée et retourne un objet OleDbCommand associé à OleDbConnection.

CreateDbBatch() (Hérité de DbConnection)
CreateDbCommand()

En cas de substitution dans une classe dérivée, crée et retourne un objet DbCommand associé à la connexion active.

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

(Hérité de MarshalByRefObject)
Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.

(Hérité de DbConnection)
Dispose()

Libère toutes les ressources utilisées par Component.

(Hérité de Component)
Dispose(Boolean)

Libère les ressources non managées utilisées par DbConnection et libère éventuellement les ressources managées.

(Hérité de DbConnection)
Dispose(Boolean)

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.

(Hérité de Component)
DisposeAsync()

Supprime de manière asynchrone l’objet de connexion.

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

S’inscrit dans la transaction spécifiée en tant que transaction distribuée.

EnlistTransaction(Transaction)

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

Fait office 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 en cours qui contrôle la stratégie de durée de vie de cette 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.

GetSchema()

Retourne les informations de schéma pour la source de données de ce 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.

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.

GetSchemaAsync(CancellationToken)

Il s'agit d’une version asynchrone de GetSchema(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le cancellationToken peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par GetSchema() sont communiquées via la propriété d'exception de tâche retournée.

(Hérité de DbConnection)
GetSchemaAsync(String, CancellationToken)

Il s'agit de la version asynchrone de GetSchema(String). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le cancellationToken peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema(String) synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par GetSchema(String) sont communiquées via la propriété d'exception de tâche retournée.

(Hérité de DbConnection)
GetSchemaAsync(String, String[], CancellationToken)

Il s'agit de la version asynchrone de GetSchema(String, String[]). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le cancellationToken peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode GetSchema(String, String[]) synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par GetSchema(String, String[]) sont communiquées via la propriété d'exception de tâche retournée.

(Hérité de DbConnection)
GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.

(Hérité de Component)
GetType()

Obtient le 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 Object actuel.

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

(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 Open(), qui ouvre une connexion de base de données avec les paramètres spécifiés par ConnectionString. Cette méthode appelle la méthode virtuelle OpenAsync(CancellationToken) avec CancellationToken.None.

(Hérité de DbConnection)
OpenAsync(CancellationToken)

Il s'agit de la version asynchrone de Open(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le jeton d'annulation peut éventuellement être respecté.

L'implémentation par défaut appelle l'appel de méthode Open() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par Open sont communiquées via la propriété d'exception de tâche retournée.

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.

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

ResetState()

Met à jour la propriété State de l'objet OleDbConnection.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
ToString()

Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée.

(Hérité de Component)

événement

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)
InfoMessage

Se produit lorsque le fournisseur envoie un avertissement ou un message d'information.

StateChange

Se produit quand l’état de la connexion change.

StateChange

Se produit quand l’état de la connexion change.

(Hérité de DbConnection)

Implémentations d’interfaces explicites

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’isolement spécifié.

IDbConnection.BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec le niveau d’isolement 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 Command associé à la connexion.

IDbConnection.CreateCommand()

Crée et retourne un objet DbCommand associé à la connexion actuelle.

(Hérité de DbConnection)

S’applique à

Voir aussi