Exécution d'une commande

  • Article

Chaque fournisseur de données .NET Framework inclus avec le .NET Framework possède son propre objet de commande qui hérite de DbCommand. Le fournisseur de données .NET Framework pour OLE DB inclut un objet OleDbCommand, le fournisseur de données .NET Framework pour SQL Server inclut un objet SqlCommand, le fournisseur de données .NET Framework pour ODBC inclut un objet OdbcCommand et le fournisseur de données .NET Framework pour Oracle inclut un objet OracleCommand. Chacun de ces objets expose des méthodes pour exécuter les commandes en fonction du type de commande et de la valeur de retour souhaitée, comme cela est décrit dans le tableau ci-dessous.

Commande Valeur renvoyée
ExecuteReader Retourne un objet DataReader.
ExecuteScalar Retourne une valeur scalaire unique.
ExecuteNonQuery Exécute une commande qui ne retourne aucune ligne.
ExecuteXMLReader Retourne un XmlReader. Disponible pour un objet SqlCommand uniquement.

Chaque objet de commande fortement typé prend également en charge une énumération CommandType qui spécifie la manière dont une chaîne de commande est interprétée, comme cela est décrit dans le tableau ci-dessous.

CommandType Description
Text Commande SQL qui définit les instructions à exécuter au niveau de la source de données.
StoredProcedure Nom de la procédure stockée. Vous pouvez utiliser la propriété Parameters d'une commande pour accéder aux paramètres d'entrée et de sortie et aux valeurs de retour, quelle que soit la méthode Execute appelée. Lorsque vous utilisez ExecuteReader, les valeurs de retour et les paramètres de sortie ne seront pas accessibles tant que DataReader ne sera pas fermé.
TableDirect Nom d'une table.

Exemple

L'exemple de code ci-dessous montre comment créer un objet SqlCommand pour exécuter une procédure stockée en définissant ses propriétés. Un objet SqlParameter permet de spécifier le paramètre d'entrée de la procédure stockée. La commande est exécutée à l'aide de la méthode ExecuteReader et la sortie de SqlDataReader est affichée dans la fenêtre de console.

static void GetSalesByCategory(string connectionString,
    string categoryName)
{
    using (SqlConnection connection = new(connectionString))
    {
        // Create the command and set its properties.
        SqlCommand command = new()
        {
            Connection = connection,
            CommandText = "SalesByCategory",
            CommandType = CommandType.StoredProcedure
        };

        // Add the input parameter and set its properties.
        SqlParameter parameter = new()
        {
            ParameterName = "@CategoryName",
            SqlDbType = SqlDbType.NVarChar,
            Direction = ParameterDirection.Input,
            Value = categoryName
        };

        // Add the parameter to the Parameters collection.
        command.Parameters.Add(parameter);

        // Open the connection and execute the reader.
        connection.Open();
        using (SqlDataReader reader = command.ExecuteReader())
        {
            if (reader.HasRows)
            {
                while (reader.Read())
                {
                    Console.WriteLine("{0}: {1:C}", reader[0], reader[1]);
                }
            }
            else
            {
                Console.WriteLine("No rows found.");
            }
            reader.Close();
        }
    }
}

Shared Sub GetSalesByCategory(ByVal connectionString As String, _
    ByVal categoryName As String)

    Using connection As New SqlConnection(connectionString)

        ' Create the command and set its properties.
        Dim command As SqlCommand = New SqlCommand()
        command.Connection = connection
        command.CommandText = "SalesByCategory"
        command.CommandType = CommandType.StoredProcedure

        ' Add the input parameter and set its properties.
        Dim parameter As New SqlParameter()
        parameter.ParameterName = "@CategoryName"
        parameter.SqlDbType = SqlDbType.NVarChar
        parameter.Direction = ParameterDirection.Input
        parameter.Value = categoryName

        ' Add the parameter to the Parameters collection.
        command.Parameters.Add(parameter)

        ' Open the connection and execute the reader.
        connection.Open()
        Using reader As SqlDataReader = command.ExecuteReader()

            If reader.HasRows Then
                Do While reader.Read()
                    Console.WriteLine("{0}: {1:C}", _
                      reader(0), reader(1))
                Loop
            Else
                Console.WriteLine("No rows returned.")
            End If
        End Using
    End Using
End Sub

Dépannage des commandes

Le fournisseur de données .NET Framework pour SQL Server ajoute des compteurs de performance pour vous permettre de détecter des problèmes intermittents liés à des échecs lors de l'exécution des commandes. Pour plus d’informations, consultez Compteurs de performance.

Voir aussi