OracleConnection Classe

Définition

Espace de noms:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.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.

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::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection

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

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

public sealed class OracleConnection : 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

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

type OracleConnection = class
    inherit DbConnection
    interface 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 Component
Implements ICloneable, IDbConnection, IDisposable

Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable

Héritage: Object

MarshalByRefObject

Component
OracleConnection

Héritage: Object

MarshalByRefObject

Component

DbConnection
OracleConnection

Attributs: ObsoleteAttribute

Implémente: IDbConnection ICloneable IDisposable

Remarques

Ce type est déconseillé et sera supprimé dans une version ultérieure de .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, il é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’une autorisation adéquate pour 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 d’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 au code (Caspol.exe) pour modifier la stratégie de sécurité sur l’ordinateur, l’utilisateur et les niveaux d’entreprise. Pour plus d’informations, voir la section Sécurité.

Note

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’expiration 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 également en charge une Database propriété ou une ChangeDatabase méthode.

Si l’objet OracleConnection sort de la portée, il reste ouvert. Par conséquent, vous devez toujours fermer OracleConnection des 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 garbage collector. En revanche, la fermeture des connexions en appelant Close utilise des ressources natives plus efficacement, en améliorant la scalabilité et en améliorant les performances globales des applications. Pour vous assurer que les connexions sont toujours fermées, ouvrez la connexion à l’intérieur d’un Using bloc.

Note

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 cela automatiquement.

Constructeurs

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

Propriétés

Nom	Description
CanRaiseEvents	Obsolète. Obtient une valeur indiquant 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 le temps d’attente pour établir une connexion avant de terminer la tentative et de générer une erreur.
Container	Obsolète. Obtient le IContainer fichier qui contient le 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 après l’ouverture d’une connexion.
DataSource	Obsolète. Obtient le nom du serveur Oracle auquel se connecter.
DbProviderFactory	Obsolète. Obtient la DbProviderFactory valeur de ce DbConnection. (Hérité de DbConnection)
DesignMode	Obsolète. Obtient une valeur qui indique si la Component valeur est actuellement en mode création. (Hérité de Component)
Events	Obsolète. Obtient la liste des gestionnaires d’événements qui sont 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 Component. (Hérité de Component)
State	Obsolète. Obtient l’état actuel de la connexion.

Méthodes

Nom	Description
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)
BeginTransaction()	Obsolète. Commence une transaction sur la base de données.
BeginTransaction(IsolationLevel)	Obsolète. Commence une transaction à la base de données avec la valeur spécifiée IsolationLevel .
ChangeDatabase(String)	Obsolète. Modifie la base de données active pour une base de données ouverte OracleConnection.
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.
CreateCommand()	Obsolète. Crée et retourne un OracleCommand objet associé au OracleConnection.
CreateDbCommand()	Obsolète. 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)	Obsolète. 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()	Obsolète. Libère toutes les ressources utilisées par le Component. (Hérité de Component)
Dispose(Boolean)	Obsolète. 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)	Obsolète. Inscrit dans la transaction spécifiée en tant que transaction distribuée.
EnlistTransaction(Transaction)	Obsolète. 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. Sert 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 actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetSchema()	Obsolète. Retourne des informations de schéma pour la source de données de ce OracleConnection.
GetSchema(String, String[])	Obsolète. Retourne des informations de schéma pour la source de données de cette OracleConnection 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)	Obsolète. Retourne des informations de schéma pour la source de données de cette OracleConnection méthode à l’aide de la chaîne spécifiée pour le nom du schéma.
GetService(Type)	Obsolète. Retourne un objet qui représente un service fourni par le Component ou par son Container. (Hérité de Component)
GetType()	Obsolète. Obtient la 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()	Obsolète. Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Obsolète. Crée une copie superficielle de l’objet actuel MarshalByRefObject . (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 le ConnectionString.
OpenAsync()	Obsolète. 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)	Obsolète. 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)
ToString()	Obsolète. 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	Obsolète. Se produit lorsque le composant est supprimé par un appel à la Dispose() méthode. (Hérité de Component)
InfoMessage	Obsolète. Se produit quand Oracle envoie un avertissement ou un message d’information.
StateChange	Obsolète. Se produit lorsque l’état de la connexion change.
StateChange	Obsolète. Se produit lorsque l’état de la connexion change. (Hérité de DbConnection)

Implémentations d’interfaces explicites

Nom	Description
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.
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 la valeur spécifiée IsolationLevel .
IDbConnection.BeginTransaction(IsolationLevel)	Obsolète. Commence une transaction de base de données avec le niveau d’isolation spécifié. (Hérité de DbConnection)
IDbConnection.ChangeDatabase(String)	Obsolète. Modifie la base de données active pour un objet Connection ouvert.
IDbConnection.CreateCommand()	Obsolète. Crée et retourne un objet Command associé à la connexion.
IDbConnection.CreateCommand()	Obsolète. Crée et retourne un DbCommand objet associé à la connexion actuelle. (Hérité de DbConnection)

S’applique à

Voir aussi

Commentaires

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