Partager via

Exécution d’une commande

Chaque fournisseur de données .NET Framework inclus avec .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 OleDbCommand objet, le fournisseur de données .NET Framework pour SQL Server inclut un SqlCommand objet, le fournisseur de données .NET Framework pour ODBC inclut un OdbcCommand objet et le fournisseur de données .NET Framework pour Oracle inclut un OracleCommand objet. Chacun de ces objets expose des méthodes d’exécution de commandes en fonction du type de commande et de la valeur de retour souhaitée, comme décrit dans le tableau suivant.

Commande Valeur de retour
ExecuteReader Renvoie 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.

Type de Commande Descriptif
Text Commande SQL définissant les instructions à exécuter à 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($"{reader[0]}: {reader[1]:C}");
                }
            }
            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

Résolution des problèmes de commandes

Le fournisseur de données .NET Framework pour SQL Server ajoute des compteurs de performances pour vous permettre de détecter des problèmes intermittents liés aux exécutions de commandes ayant échoué. Pour plus d’informations, consultez Compteurs de performances.

Voir aussi

  • Last updated on