OracleConnection Classe

Définition

Espace de noms:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Attention

OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Représente une connexion ouverte à une base de données. Cette classe ne peut pas être héritée.

public ref class OracleConnection sealed : System::Data::Common::DbConnection, ICloneable

[System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnection : System.Data.Common.DbConnection, ICloneable

[<System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable

Héritage

Object

MarshalByRefObject

Component

DbConnection

OracleConnection

Attributs

ObsoleteAttribute

Implémente

ICloneable

Exemples

L’exemple suivant crée un OracleCommand et un OracleConnection. est OracleConnection ouvert et défini comme OracleCommand.Connection propriété . L’exemple appelle ExecuteNonQueryensuite et ferme la connexion. Pour ce faire, le ExecuteNonQuery est passé une chaîne de connexion et une chaîne de requête qui est une instruction SQL INSERT.

public void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString);
        command.Connection = connection;
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Public Sub InsertRow(ByVal connectionString As String)
    Dim queryString As String = _
      "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')"

    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString)
        command.Connection = connection
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using
End Sub

Remarques

Ce type est déconseillé et sera supprimé dans une version ultérieure du .NET Framework. Pour plus d’informations, consultez Oracle et ADO.NET.

Un OracleConnection objet représente une connexion unique à une base de données Oracle. Dans le cas d’un système de base de données client/serveur, cela équivaut à une connexion réseau au serveur.

Une application qui crée une instance de l’objet OracleConnection peut définir des exigences de sécurité déclaratives ou impératives qui nécessitent que tous les appelants directs et indirects disposent d’autorisations adéquates sur le code. OracleConnection crée des demandes de sécurité à l’aide de l’objet OraclePermission . Les utilisateurs peuvent vérifier que leur code dispose des autorisations adéquates à l’aide de l’objet OraclePermissionAttribute . Les utilisateurs et les administrateurs peuvent également utiliser l’outil de stratégie de sécurité d’accès du code (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é.

Notes

Contrairement à l’objet Connection dans les autres fournisseurs de données .NET Framework (SQL Server, OLE DB et ODBC), OracleConnection ne prend pas en charge une ConnectionTimeout propriété. La définition d’un délai d’attente de connexion en tant que propriété ou dans la chaîne de connexion n’a aucun effet, et la valeur retournée est toujours égale à zéro. OracleConnection ne prend pas non plus en charge une Database propriété ou une ChangeDatabase méthode.

Si l’objet OracleConnection sort de l’étendue, il reste ouvert. Par conséquent, vous devez toujours fermer OracleConnection les objets en appelant Close ou Dispose, ou en utilisant l’objet OracleConnection dans une Using instruction . Sinon, le garbage collection risque de ne pas les libérer immédiatement. Ces retards peuvent entraîner des erreurs si le nombre maximal de connexions est atteint alors qu’un certain nombre de connexions attendent d’être supprimées par le récupérateur de mémoire. En revanche, la fermeture des connexions en appelant Close utilise les ressources natives plus efficacement, ce qui améliore la scalabilité et améliore les performances globales de l’application. Pour vous assurer que les connexions sont toujours fermées, ouvrez la connexion à l’intérieur d’un Using bloc.

Notes

Pour déployer des applications hautes performances, vous devez souvent utiliser le regroupement de connexions. Toutefois, lorsque vous utilisez le fournisseur de données .NET Framework pour Oracle, vous n’avez pas besoin d’activer le regroupement de connexions, car le fournisseur gère automatiquement cette opération.

Constructeurs

OracleConnection()	Obsolète. Initialise une nouvelle instance de l'objet OracleConnection.
OracleConnection(String)	Obsolète. Initialise une nouvelle instance de la classe OracleConnection avec la chaîne de connexion spécifiée.

Propriétés

CanCreateBatch	Obsolète. Obtient une valeur qui indique si cette instance DbConnection prend en charge la classe DbBatch. (Hérité de DbConnection)
CanRaiseEvents	Obsolète. Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
ConnectionString	Obsolète. Obtient ou définit la chaîne utilisée pour ouvrir une base de données Oracle.
ConnectionTimeout	Obsolète. 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.
Container	Obsolète. Obtient le IContainer qui contient la Component. (Hérité de Component)
Database	Obsolète. Obtient le nom de la base de données active ou de la base de données à utiliser une fois la connexion ouverte.
DataSource	Obsolète. Obtient le nom du serveur Oracle auquel se connecter.
DbProviderFactory	Obsolète. Obtient le DbProviderFactory pour ce DbConnection. (Hérité de DbConnection)
DesignMode	Obsolète. Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obsolète. Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
ServerVersion	Obsolète. Obtient une chaîne contenant la version du serveur auquel le client est connecté.
Site	Obsolète. Obtient ou définit le ISite de Component. (Hérité de Component)
State	Obsolète. Obtient l’état actuel de la connexion.

Méthodes

BeginDbTransaction(IsolationLevel)	Obsolète. 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)	Obsolète. Démarre de manière asynchrone une transaction de base de données. (Hérité de DbConnection)
BeginTransaction()	Obsolète. Commence une transaction dans la base de données.
BeginTransaction(IsolationLevel)	Obsolète. Commence une transaction dans la base de données avec la valeur IsolationLevel spécifiée.
BeginTransactionAsync(CancellationToken)	Obsolète. Commence de manière asynchrone une transaction de base de données. (Hérité de DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Obsolète. Commence de manière asynchrone une transaction de base de données. (Hérité de DbConnection)
ChangeDatabase(String)	Obsolète. Modifie la base de données actuelle d'une connexion OracleConnection établie.
ChangeDatabaseAsync(String, CancellationToken)	Obsolète. Change de manière asynchrone la base de données actuelle pour une connexion ouverte. (Hérité de DbConnection)
ClearAllPools()	Obsolète. Vide le pool de connexions.
ClearPool(OracleConnection)	Obsolète. Vide le pool de connexions associé à la connexion spécifiée.
Close()	Obsolète. Ferme la connexion à la base de données.
CloseAsync()	Obsolète. Ferme de manière asynchrone la connexion à la base de données. (Hérité de DbConnection)
CreateBatch()	Obsolète. Retourne une nouvelle instance de la classe du fournisseur qui implémente la classe DbBatch. (Hérité de DbConnection)
CreateCommand()	Obsolète. Crée et retourne un objet OracleCommand associé à OracleConnection.
CreateDbBatch()	Obsolète. En cas de substitution dans une classe dérivée, retourne une nouvelle instance de la classe du fournisseur qui implémente la DbBatch classe . (Hérité de DbConnection)
CreateDbCommand()	Obsolète. 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)	Obsolète. 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()	Obsolète. 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(Boolean)	Obsolète. Libère les ressources non managées utilisées par DbConnection et libère éventuellement les ressources managées. (Hérité de DbConnection)
DisposeAsync()	Obsolète. Supprime de manière asynchrone l’objet de connexion. (Hérité de DbConnection)
EnlistDistributedTransaction(ITransaction)	Obsolète. S’inscrit dans la transaction spécifiée en tant que transaction distribuée.
EnlistTransaction(Transaction)	Obsolète. S’inscrit dans la transaction spécifiée en tant que transaction distribuée.
Equals(Object)	Obsolète. Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Obsolète. Fait office de fonction de hachage par défaut. (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. (Hérité de MarshalByRefObject)
GetSchema()	Obsolète. Retourne les informations de schéma pour la source de données de ce OracleConnection.
GetSchema(String)	Obsolète. Retourne des informations de schéma pour la source de données de ce OracleConnection à l’aide de la chaîne spécifiée pour le nom de schéma.
GetSchema(String, String[])	Obsolète. Retourne les informations de schéma pour la source de données de ce OracleConnection à 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)	Obsolète. 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)	Obsolète. 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)	Obsolète. 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)	Obsolète. Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obsolète. Obtient le 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()	Obsolète. Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Obsolète. Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Obsolète. Déclenche l’événement StateChange. (Hérité de DbConnection)
Open()	Obsolète. Ouvre une connexion à une base de données avec les paramètres de propriété spécifiés par ConnectionString.
OpenAsync()	Obsolète. 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)	Obsolète. 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)
ToString()	Obsolète. 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énements

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

Implémentations d’interfaces explicites

ICloneable.Clone()	Obsolète. Crée un objet qui est une copie de l'instance actuelle.
IDbConnection.BeginTransaction()	Obsolète. Commence une transaction de base de données. (Hérité de DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Obsolète. Commence une transaction de base de données avec le niveau d’isolement spécifié. (Hérité de DbConnection)
IDbConnection.CreateCommand()	Obsolète. Crée et retourne un objet DbCommand associé à la connexion actuelle. (Hérité de DbConnection)

Voir aussi

• OracleDataAdapter
• OracleCommand