Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

OracleCommand classe

 

Date de publication : novembre 2016

Remarque : Cette API est désormais obsolète.

Représente une instruction SQL ou une procédure stockée à exécuter sur une source de données. Cette classe ne peut pas être héritée.

Espace de noms:   System.Data.OracleClient
Assembly:  System.Data.OracleClient (dans System.Data.OracleClient.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbCommand
        System.Data.OracleClient.OracleCommand

[ObsoleteAttribute("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", 
	false)]
public sealed class OracleCommand : DbCommand, ICloneable

NomDescription
System_CAPS_pubmethodOracleCommand()

Initialise une nouvelle instance de l'objet OracleCommand.

System_CAPS_pubmethodOracleCommand(String)

Initialise une nouvelle instance de la classe OracleCommand avec le texte de la requête.

System_CAPS_pubmethodOracleCommand(String, OracleConnection)

Initialise une nouvelle instance de la OracleCommand classe avec le texte de la requête et un OracleConnection objet.

System_CAPS_pubmethodOracleCommand(String, OracleConnection, OracleTransaction)

Initialise une nouvelle instance de la OracleCommand classe avec le texte de la requête, une OracleConnection objet et un OracleTransaction.

NomDescription
System_CAPS_pubpropertyCommandText

Obtient ou définit l’instruction SQL ou une procédure stockée à exécuter par rapport à la base de données.(Remplace DbCommand.CommandText.)

System_CAPS_pubpropertyCommandTimeout

Obtient ou définit la durée d'attente qui précède le moment où il est mis fin à une tentative d'exécution d'une commande et où une erreur est générée.(Remplace DbCommand.CommandTimeout.)

System_CAPS_pubpropertyCommandType

Obtient ou définit une valeur indiquant comment la CommandText propriété est interprétée.(Remplace DbCommand.CommandType.)

System_CAPS_pubpropertyConnection

Obtient ou définit le OracleConnection utilisé par cette instance de la OracleCommand.

System_CAPS_pubpropertyContainer

Obtient les IContainer qui contient la Component.(Hérité de Component.)

System_CAPS_pubpropertyDesignTimeVisible

Obtient ou définit une valeur indiquant si l’objet command doit être visible dans un contrôle d’interface personnalisé.(Remplace DbCommand.DesignTimeVisible.)

System_CAPS_pubpropertyParameters
System_CAPS_pubpropertySite

Obtient ou définit le ISite de la Component.(Hérité de Component.)

System_CAPS_pubpropertyTransaction

Obtient ou définit l'objet OracleTransaction dans lequel OracleCommand s'exécute.

System_CAPS_pubpropertyUpdatedRowSource

Obtient ou définit une valeur qui spécifie comment la Update méthode doit appliquer les résultats de la commande à le DataRow.(Remplace DbCommand.UpdatedRowSource.)

NomDescription
System_CAPS_pubmethodCancel()

Tente d’annuler l’exécution d’une OracleCommand.(Remplace DbCommand.Cancel().)

System_CAPS_pubmethodClone()

Crée une copie de cette OracleCommand objet.

System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodCreateParameter()

Crée une instance d’un OracleParameter objet.

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par Component.(Hérité de Component.)

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodExecuteNonQuery()

Exécute une instruction SQL par rapport à la Connection et retourne le nombre de lignes affectées.(Remplace DbCommand.ExecuteNonQuery().)

System_CAPS_pubmethodExecuteNonQueryAsync()

Une version asynchrone de ExecuteNonQuery, qui exécute une instruction SQL par rapport à un objet de connexion.

Appelle ExecuteNonQueryAsync avec CancellationToken.None.(Hérité de DbCommand.)

System_CAPS_pubmethodExecuteNonQueryAsync(CancellationToken)

C’est la version asynchrone de ExecuteNonQuery. Les fournisseurs doivent substituer avec une implémentation appropriée. Le jeton d’annulation peut éventuellement être ignoré.

L’implémentation par défaut appelle synchrones ExecuteNonQuery méthode et retourne une tâche terminée, bloquer le thread appelant. L’implémentation par défaut retourne une tâche annulée si passé un jeton d’annulation déjà annulée. Les exceptions levées par ExecuteNonQuery seront communiquées via la propriété Exception de la tâche retournée.

N’appellent pas d’autres méthodes et propriétés de le DbCommand de l’objet jusqu'à la fin de la tâche retournée.(Hérité de DbCommand.)

System_CAPS_pubmethodExecuteOracleNonQuery(OracleString)

Exécute une instruction SQL par rapport à la Connection et retourne le nombre de lignes affectées.

System_CAPS_pubmethodExecuteOracleScalar()

Exécute la requête et retourne la première colonne de la première ligne du jeu de résultats retourné par la requête comme un type de données spécifique Oracle. Colonnes ou lignes supplémentaires sont ignorées.

System_CAPS_pubmethodExecuteReader()

Envoie le CommandText à la Connection et génère une OracleDataReader.

System_CAPS_pubmethodExecuteReader(CommandBehavior)

Envoie le CommandText à la Connection, et génère un OracleDataReader à l’aide d’une de la CommandBehavior valeurs.

System_CAPS_pubmethodExecuteReaderAsync()

Une version asynchrone de ExecuteReader, qui exécute le CommandText contre la Connection et retourne un DbDataReader.

Appelle ExecuteDbDataReaderAsync avec CancellationToken.None.(Hérité de DbCommand.)

System_CAPS_pubmethodExecuteReaderAsync(CancellationToken)

Une version asynchrone de ExecuteReader, qui exécute le CommandText contre la Connection et retourne un DbDataReader. Cette méthode propage une notification que les opérations doivent être annulées.

Appelle ExecuteDbDataReaderAsync.(Hérité de DbCommand.)

System_CAPS_pubmethodExecuteReaderAsync(CommandBehavior)

Une version asynchrone de ExecuteReader, qui exécute le CommandText contre la Connection et retourne un DbDataReader.

Appelle ExecuteDbDataReaderAsync.(Hérité de DbCommand.)

System_CAPS_pubmethodExecuteReaderAsync(CommandBehavior, CancellationToken)

Appelle ExecuteDbDataReaderAsync.(Hérité de DbCommand.)

System_CAPS_pubmethodExecuteScalar()

Exécute la requête et retourne la première colonne de la première ligne du jeu de résultats retourné par la requête comme un type de données .NET Framework. Colonnes ou lignes supplémentaires sont ignorées.(Remplace DbCommand.ExecuteScalar().)

System_CAPS_pubmethodExecuteScalarAsync()

Une version asynchrone de ExecuteScalar, qui exécute la requête et retourne la première colonne de la première ligne du jeu de résultats retourné par la requête. Toutes les autres colonnes et lignes sont ignorées.

Appelle ExecuteScalarAsync avec CancellationToken.None.(Hérité de DbCommand.)

System_CAPS_pubmethodExecuteScalarAsync(CancellationToken)

C’est la version asynchrone de ExecuteScalar. Les fournisseurs doivent substituer avec une implémentation appropriée. Le jeton d’annulation peut éventuellement être ignoré.

L’implémentation par défaut appelle synchrones ExecuteScalar méthode et retourne une tâche terminée, bloquer le thread appelant. L’implémentation par défaut retourne une tâche annulée si passé un jeton d’annulation déjà annulée. Les exceptions levées par ExecuteScalar seront communiquées via la propriété Exception de la tâche retournée.

N’appellent pas d’autres méthodes et propriétés de le DbCommand de l’objet jusqu'à la fin de la tâche retournée.(Hérité de DbCommand.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetLifetimeService()

Récupère l’objet de service de durée de vie actuelle qui contrôle la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

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

System_CAPS_pubmethodPrepare()

Crée une version préparée (ou compilée) de la commande à la source de données.(Remplace DbCommand.Prepare().)

System_CAPS_pubmethodResetCommandTimeout()

Réinitialise le CommandTimeout propriété à la valeur par défaut.

System_CAPS_pubmethodToString()

Retourne un String contenant le nom de la Component, le cas échéant. Cette méthode ne doit pas être remplacée.(Hérité de Component.)

NomDescription
System_CAPS_pubeventDisposed

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

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.CreateParameter()

Crée une nouvelle instance d’un objet IDbDataParameter.(Hérité de DbCommand.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.ExecuteReader()

Exécute le CommandText contre le Connection et génère un IDataReader.(Hérité de DbCommand.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbCommand.ExecuteReader(CommandBehavior)

Exécute le CommandText sur le Connection, et génère un IDataReader à l’aide d’une des valeurs CommandBehavior.(Hérité de DbCommand.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Connection

Obtient ou définit le IDbConnection utilisé par cette instance du IDbCommand.(Hérité de DbCommand.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Parameters

Obtient IDataParameterCollection.(Hérité de DbCommand.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDbCommand.Transaction

Obtient ou définit la DbTransaction dans laquelle l’objet DbCommand s’exécute.(Hérité de DbCommand.)

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

La OracleCommand classe fournit les méthodes suivantes pour exécuter des commandes sur une source de données :

Élément

Description

ExecuteReader

Exécute des commandes qui retournent des lignes.

ExecuteOracleNonQuery

Exécute une instruction SQL par rapport à la Connection et retourne le nombre de lignes affectées.

ExecuteNonQuery

Exécute des commandes telles que des instructions SQL INSERT, DELETE, UPDATE et SET.

ExecuteScalar

Récupère une valeur unique (par exemple, une valeur d’agrégation) d’une base de données comme type de données .NET Framework.

ExecuteOracleScalar

Récupère une valeur unique (par exemple, une valeur d’agrégation) à partir d’une base de données en un type de données spécifique Oracle.

Vous pouvez réinitialiser le CommandText propriété et la réutilisation du OracleCommand objet.

Si l’exécution de la commande génère une erreur fatale OracleException, le OracleConnection peut se fermer. L'utilisateur peut toutefois rouvrir la connexion et continuer.

System_CAPS_noteRemarque

Contrairement à la commande objet dans les autres fournisseurs de données .NET Framework (SQL Server, OLE DB et ODBC), le OracleCommand objet ne prend pas en charge un CommandTimeout propriété. Définir un délai d’expiration de la commande n’a aucun effet et la valeur retournée est toujours égal à zéro.

L’exemple suivant utilise le ExecuteReader méthode OracleCommand, avec OracleDataReader et OracleConnection, pour sélectionner les lignes d’une table.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT EmpNo, DeptNo FROM Scott.Emp";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();
        OracleDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetInt32(1));
            }
        }
        finally
        {
            // always call Close when done reading.
            reader.Close();
        }
    }
}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: