OracleConnection Classe

Définition

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
Héritage
Attributs
Implémente

Exemples

L’exemple suivant crée un OracleCommand et un OracleConnection . Le OracleConnection est ouvert et défini en tant que OracleCommand.Connection propriété. 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 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 future version 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, il est équivalent à une connexion réseau au serveur.

Une application qui crée une instance de l' OracleConnection objet peut définir des demandes de sécurité déclaratives ou impératives qui requièrent que tous les appelants directs et indirects disposent de l’autorisation adéquate pour le code. OracleConnection crée des demandes de sécurité à l’aide de l' OraclePermission objet. Les utilisateurs peuvent vérifier que leur code dispose des autorisations appropriées à l’aide de l' OraclePermissionAttribute objet. Les utilisateurs et les administrateurs peuvent également utiliser l’outil 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 de connexion 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 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' OracleConnection objet est hors de portée, il reste ouvert. Par conséquent, vous devez toujours fermer OracleConnection les objets en appelant Close ou dispose, ou en utilisant l' OracleConnection objet dans une Using instruction. Dans le cas contraire, il se peut que le garbage collection ne les libère pas immédiatement. Ce type de retards peut provoquer des erreurs si le nombre maximal de connexions est atteint alors que le garbage collector attend la suppression de plusieurs connexions. En revanche, la fermeture des connexions en appelant Close utilise des ressources natives plus efficacement, en améliorant l’évolutivité et en améliorant 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 le gère automatiquement.

Constructeurs

OracleConnection()

Initialise une nouvelle instance de l'objet OracleConnection.

OracleConnection(String)

Initialise une nouvelle instance de la classe OracleConnection 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 Oracle.

ConnectionTimeout

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

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 du serveur Oracle auquel se connecter.

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)
ServerVersion

Obtient une chaîne contenant 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 dans la base de données.

BeginTransaction(IsolationLevel)

Commence une transaction dans la base de données avec la valeur IsolationLevel spécifiée.

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 OracleConnection établie.

ChangeDatabaseAsync(String, CancellationToken)

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

(Hérité de DbConnection)
ClearAllPools()

Vide le pool de connexions.

ClearPool(OracleConnection)

Vide le pool de connexions associé à la connexion spécifiée.

Close()

Ferme la connexion à la base 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 OracleCommand associé à OracleConnection.

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

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

(Hérité de Component)
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(Boolean)

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

(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)
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)
GetSchema()

Retourne les informations de schéma pour la source de données de ce OracleConnection.

GetSchema(String)

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[])

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)

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 à une base de données avec les paramètres de propriété spécifiés par 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)
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énements

Disposed

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

(Hérité de Component)
InfoMessage

Se produit lorsque Oracle 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()

Crée un objet qui est une copie de l'instance actuelle.

IDbConnection.BeginTransaction()

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)

Commence une transaction de base de données avec la valeur de champ IsolationLevel spécifiée.

IDbConnection.BeginTransaction(IsolationLevel)

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

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

Change la base de données actuelle d’un objet Connection ouvert.

IDbConnection.CreateCommand()

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