OracleConnection Classe

Définition

Avertissement

Cette API est désormais obsolète.

Représente une connexion ouverte à une base de données.Represents an open connection to a database. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
type OracleConnection = class
    inherit DbConnection
    interface ICloneable
Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable
Héritage
Attributs
Implémente

Exemples

L’exemple suivant crée un OracleCommand et un OracleConnection.The following example creates an OracleCommand and an OracleConnection. La OracleConnection est ouverte et définie en tant que propriété OracleCommand.Connection.The OracleConnection is opened and set as the OracleCommand.Connection property. L’exemple appelle ensuite ExecuteNonQueryet ferme la connexion.The example then calls ExecuteNonQuery, and closes the connection. Pour ce faire, la ExecuteNonQuery reçoit une chaîne de connexion et une chaîne de requête qui est une instruction SQL INSERT.To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is an SQL INSERT statement.

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.This type is deprecated and will be removed in a future version of the .NET Framework. Pour plus d’informations, consultez Oracle et ADO.net.For more information, see Oracle and ADO.NET.

Un objet OracleConnection représente une connexion unique à une base de données Oracle.An OracleConnection object represents a unique connection to an Oracle database. Dans le cas d’un système de base de données client/serveur, il est équivalent à une connexion réseau au serveur.In the case of a client/server database system, it is equivalent to a network connection to the server.

Une application qui crée une instance de l’objet OracleConnection 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.An application that creates an instance of the OracleConnection object can set declarative or imperative security demands that require all direct and indirect callers to have adequate permission to the code. OracleConnection crée des demandes de sécurité à l’aide de l’objet OraclePermission.OracleConnection creates security demands by using the OraclePermission object. Les utilisateurs peuvent vérifier que leur code dispose des autorisations adéquates à l’aide de l’objet OraclePermissionAttribute.Users can verify that their code has adequate permissions by using the OraclePermissionAttribute object. 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.Users and administrators can also use the Code Access Security Policy Tool (Caspol.exe) to modify security policy at the machine, user, and enterprise levels. Pour plus d’informations, consultez Sécurité.For more information, see Security.

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 propriété ConnectionTimeout.Unlike the Connection object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), OracleConnection does not support a ConnectionTimeout property. 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.Setting a connection time-out either as a property or in the connection string has no effect, and the value returned is always zero. OracleConnection ne prend pas non plus en charge une propriété Database ou une méthode ChangeDatabase.OracleConnection also does not support a Database property or a ChangeDatabase method.

Si l’objet OracleConnection est hors de portée, il reste ouvert.If the OracleConnection object goes out of scope, it remains open. Par conséquent, vous devez toujours fermer OracleConnection objets en appelant Close ou dispose, ou en utilisant l’objet OracleConnection dans une instruction Using.Therefore, you should always close OracleConnection objects by calling Close or Dispose, or by using the OracleConnection object within a Using statement. Dans le cas contraire, il se peut que le garbage collection ne les libère pas immédiatement.Otherwise, the garbage collection might not free them immediately. 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.Such delays can cause errors if the maximum number of connections is reached while a number of connections are waiting to be deleted by the garbage collector. En revanche, la fermeture des connexions en appelant Close utilise des ressources natives de manière plus efficace, ce qui améliore l’évolutivité et améliore les performances globales de l’application.By contrast, closing the connections by calling Close uses native resources more efficiently, enhancing scalability and improving overall application performance. Pour vous assurer que les connexions sont toujours fermées, ouvrez la connexion à l’intérieur d’un bloc de Using.To ensure that connections are always closed, open the connection inside of a Using block.

Notes

Pour déployer des applications à hautes performances, vous devez souvent utiliser le regroupement de connexions.To deploy high-performance applications, you often need to use connection pooling. 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.However, when you use the .NET Framework Data Provider for Oracle, you do not need to enable connection pooling because the provider manages this automatically.

Constructeurs

OracleConnection()

Initialise une nouvelle instance de OracleConnection.Initializes a new instance of the OracleConnection.

OracleConnection(String)

Initialise une nouvelle instance de la classe OracleConnection avec la chaîne de connexion spécifiée.Initializes a new instance of the OracleConnection class with the specified connection string.

Propriétés

CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Hérité de Component)
ConnectionString

Obtient ou définit la chaîne utilisée pour ouvrir une base de données Oracle.Gets or sets the string used to open an Oracle database.

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.Gets the time to wait to establish a connection before terminating the attempt and generating an error.

Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the 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.Gets the name of the current database or the database to be used after a connection is opened.

DataSource

Obtient le nom du serveur Oracle auquel se connecter.Gets the name of the Oracle server to which to connect.

DbProviderFactory

Obtient le DbProviderFactory pour ce DbConnection.Gets the DbProviderFactory for this DbConnection.

(Hérité de DbConnection)
DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this Component.

(Hérité de Component)
ServerVersion

Obtient une chaîne contenant la version du serveur auquel le client est connecté.Gets a string containing the version of the server to which the client is connected.

Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Hérité de Component)
State

Obtient l’état actuel de la connexion.Gets the current state of the connection.

Méthodes

BeginDbTransaction(IsolationLevel)

En cas de substitution dans une classe dérivée, démarre une transaction de base de données.When overridden in a derived class, starts a database transaction.

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

Démarre de manière asynchrone une transaction de base de données.Asynchronously starts a database transaction.

(Hérité de DbConnection)
BeginTransaction()

Commence une transaction dans la base de données.Begins a transaction at the database.

BeginTransaction(IsolationLevel)

Commence une transaction dans la base de données avec la valeur IsolationLevel spécifiée.Begins a transaction at the database with the specified IsolationLevel value.

BeginTransactionAsync(CancellationToken)

Commence de manière asynchrone une transaction de base de données.Asynchronously begins a database transaction.

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

Commence de manière asynchrone une transaction de base de données.Asynchronously begins a database transaction.

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

Modifie la base de données actuelle d'une connexion OracleConnection établie.Changes the current database for an open OracleConnection.

ChangeDatabaseAsync(String, CancellationToken)

Change de manière asynchrone la base de données actuelle pour une connexion ouverte.Asynchronously changes the current database for an open connection.

(Hérité de DbConnection)
ClearAllPools()

Vide le pool de connexions.Empties the connection pool.

ClearPool(OracleConnection)

Vide le pool de connexions associé à la connexion spécifiée.Empties the connection pool associated with the specified connection.

Close()

Ferme la connexion à la base de données.Closes the connection to the database.

CloseAsync()

Ferme de manière asynchrone la connexion à la base de données.Asynchronously closes the connection to the database.

(Hérité de DbConnection)
CreateCommand()

Crée et retourne un objet OracleCommand associé à OracleConnection.Creates and returns an OracleCommand object associated with the OracleConnection.

CreateDbCommand()

En cas de substitution dans une classe dérivée, crée et retourne un objet DbCommand associé à la connexion active.When overridden in a derived class, creates and returns a DbCommand object associated with the current connection.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the Component.

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

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Hérité de Component)
DisposeAsync()

Supprime de manière asynchrone l’objet de connexion.Asynchronously diposes the connection object.

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

S'inscrit dans la transaction spécifiée en tant que transaction distribuée.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction)

S'inscrit dans la transaction spécifiée en tant que transaction distribuée.Enlists in the specified transaction as a distributed transaction.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetSchema()

Retourne les informations de schéma pour la source de données de ce OracleConnection.Returns schema information for the data source of this 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.Returns schema information for the data source of this OracleConnection using the specified string for the schema name.

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.Returns schema information for the data source of this OracleConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Hérité de Component)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
OnStateChange(StateChangeEventArgs)

Déclenche l'événement StateChange.Raises the StateChange event.

(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.Opens a connection to a database with the property settings specified by the ConnectionString.

OpenAsync()

Version asynchrone de Open(), qui ouvre une connexion de base de données avec les paramètres spécifiés par ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Cette méthode appelle la méthode virtuelle OpenAsync(CancellationToken) avec CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

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

Il s'agit de la version asynchrone de Open().This is the asynchronous version of Open(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée.Providers should override with an appropriate implementation. Le jeton d'annulation peut éventuellement être respecté.The cancellation token can optionally be honored.

L'implémentation par défaut appelle l'appel de méthode Open() synchrone et retourne une tâche terminée.The default implementation invokes the synchronous Open() call and returns a completed task. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Les exceptions levées par Open sont communiquées via la propriété d'exception de tâche retournée.Exceptions thrown by Open will be communicated via the returned Task Exception property.

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.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

(Hérité de DbConnection)
ToString()

Retourne un String contenant le nom du Component, s’il en existe un.Returns a String containing the name of the Component, if any. Cette méthode ne doit pas être remplacée.This method should not be overridden.

(Hérité de Component)

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Hérité de Component)
InfoMessage

Se produit lorsque Oracle envoie un avertissement ou un message d'information.Occurs when Oracle sends a warning or an informational message.

StateChange

Se produit quand l’état de la connexion change.Occurs when the state of the connection changes.

Implémentations d’interfaces explicites

ICloneable.Clone()

Crée un nouvel objet qui est une copie de l'instance actuelle.Creates a new object that is a copy of the current instance.

IDbConnection.BeginTransaction()

Commence une transaction de base de données.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel)

Commence une transaction de base de données avec la valeur de champ IsolationLevel spécifiée.Begins a database transaction with the specified IsolationLevel value.

IDbConnection.ChangeDatabase(String)

Change la base de données actuelle d’un objet Connection ouvert.Changes the current database for an open Connection object.

IDbConnection.CreateCommand()

Crée et retourne un objet Command associé à la connexion.Creates and returns a Command object that is associated with the connection.

S’applique à

Voir aussi