SqlCommand.ExecuteNonQuery, méthode

public override int ExecuteNonQuery()

public int ExecuteNonQuery()

public override function ExecuteNonQuery() : int

Implémentations

Vous pouvez utiliser ExecuteNonQuery pour effectuer des opérations portant sur un catalogue (par exemple, l'interrogation de la structure d'une base de données ou la création d'objets de base de données, tels que des tables) ou pour modifier les données d'une base de données sans utiliser DataSet en exécutant des instructions UPDATE, INSERT ou DELETE.

Même si ExecuteNonQuery ne retourne pas de ligne, les paramètres de sortie et les valeurs de retour éventuellement mappés aux paramètres sont remplis avec des données.

Pour les instructions UPDATE, INSERT et DELETE, les valeurs de retour représentent le nombre de lignes affectées par la commande. Lorsqu'un déclencheur existe sur une table qui est insérée ou mise à jour, la valeur de retour inclut à la fois le nombre de lignes affectées par l'opération d'insertion ou de mise à jour et le nombre de lignes affectées par le ou les déclencheurs. Pour tous les autres types d'instructions, la valeur de retour est -1. En cas d'annulation, la valeur de retour est la même -1.

L'exemple suivant crée un SqlCommand, puis l'exécute à l'aide de ExecuteNonQuery. Une chaîne qui est une instruction Transact-SQL (telle que UPDATE, INSERT ou DELETE) et une chaîne à utiliser pour se connecter à la source de données sont passées à l'exemple.

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

.NET Compact Framework

Référence

Autres ressources