Comment : créer et exécuter une instruction SQL qui retourne une seule valeur

Article
08/19/2016

Publication: juillet 2016

Pour exécuter une instruction SQL qui retourne une valeur unique, vous pouvez lancer une requête TableAdapter configurée pour exécuter une instruction SQL (par exemple, CustomersTableAdapter.CustomerCount()).

Si votre application n'utilise pas de TableAdapters, appelez la méthode ExecuteScalar sur un objet de commande en affectant à sa propriété CommandType la valeur Text. (L'« objet de commande » fait référence à la commande spécifique au fournisseur de données .NET Framework que votre application utilise. Par exemple, si votre application utilise le fournisseur de données .NET Framework pour SQL Server, l'objet de commande est SqlCommand.)

Les exemples suivants illustrent l'exécution d'instructions SQL qui retournent des valeurs uniques provenant d'une base de données à l'aide de TableAdapters ou d'objets de commande. Pour plus d'informations sur la façon d'interroger à l'aide de TableAdapters et de commandes, consultez Remplissage de groupes de données avec des données.

Notes

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, consultez Personnalisation de l'IDE de Visual Studio.

Exécution d'instructions SQL qui retournent des valeurs uniques à l'aide d'un TableAdapter

Cet exemple illustre la création d'une requête TableAdapter à l'aide de l'Configuration de requête TableAdapter (Assistant), puis fournit des informations sur la manière de déclarer une instance de TableAdapter et d'exécuter la requête.

Pour créer une instruction SQL qui retourne une valeur unique à l'aide d'un TableAdapter

Ouvrez un groupe de données dans le Concepteur de DataSet. Pour plus d'informations, consultez Comment : ouvrir un groupe de données dans le Concepteur de DataSet.
S'il n'existe pas encore de TableAdapter, créez-en un. Pour plus d'informations sur la création de TableAdapters, consultez Comment : créer des TableAdapters.
Si vous disposez déjà dans votre TableAdapter d'une requête qui utilise une instruction SQL pour retourner une valeur unique, passez à la procédure suivante, « Pour déclarer une instance du TableAdapter et exécuter la requête ». Sinon, passez à l'étape 4 pour créer une nouvelle requête qui retourne une valeur unique.
Cliquez avec le bouton droit sur le TableAdapter de votre choix et utilisez le menu contextuel pour ajouter une requête.

L'Assistant Configuration de requêtes TableAdapter s'ouvre.
Conservez la valeur par défaut (Utiliser des instructions SQL), puis cliquez sur Suivant.
Choisissez l'option SELECT qui retourne une seule valeur, puis cliquez sur Suivant.
Tapez votre instruction SQL ou utilisez le Générateur de requêtes pour vous aider à la créer, puis cliquez sur Suivant.
Spécifiez le nom de la requête.
Une fois l'Assistant terminé, la requête est ajoutée au TableAdapter.
Générez votre projet.

Pour déclarer une instance du TableAdapter et exécuter la requête

Déclarez une instance du TableAdapter qui contient la requête que vous souhaitez exécuter.
- Pour créer une instance qui utilise des outils de conception, faites glisser le TableAdapter de votre choix de la Boîte à outils. (Les composants contenus dans votre projet apparaissent maintenant dans la Boîte à outils sous un titre qui correspond à votre nom de projet.) Si le TableAdapter n'est pas affiché dans la Boîte à outils, il se peut que vous deviez générer votre projet.
  
  ou
- Pour créer une instance dans du code, remplacez le code suivant par les noms de votre DataSet et de votre TableAdapter.
  
  Dim tableAdapter As New DataSetTableAdapters.TableAdapter
  
  Notes
  
  Les TableAdapters ne se trouvent pas réellement à l'intérieur de leurs classes DataSet associées.Chaque groupe de données possède une collection correspondante de TableAdapters dans son propre espace de noms.Par exemple, si vous disposez d'un groupe de données nommé SalesDataSet, il existe un espace de noms SalesDataSetTableAdapters contenant ses TableAdapters.
Appelez votre requête comme s'il s'agissait de toute autre méthode dans du code. Votre requête est une méthode sur le TableAdapter. Remplacez le code suivant par les noms de votre TableAdapter et de votre requête. Vous devez également passer tous les paramètres requis par votre requête et exploiter la valeur de retour (par exemple, l'assigner à une variable). Si vous ne savez pas si votre requête exige des paramètres, ni quels paramètres sont nécessaires, recherchez dans IntelliSense la signature nécessaire à la requête. Selon que votre requête prend ou non des paramètres, le code peut se présenter comme l'un des exemples suivants :

TableAdapter.Query()

TableAdapter.Query(Parameters)
Vous devrez probablement assigner la valeur retournée par la requête à une variable. Les requêtes TableAdapter qui retournent une valeur unique retourneront un type de données en fonction de la requête (contrairement à la méthode ExecuteScalar qui retourne un objet). Par exemple, si votre requête TableAdapter sélectionne une colonne unique dont les données sont de type entier, la valeur de retour de la requête est un entier. Si la colonne autorise les valeurs null, la valeur de retour possède l'un des types Nullable (par exemple, Nullable(Of Integer)). Pour plus d'informations sur les types Nullable, consultez Nullable. Le code complet permettant de déclarer une instance d'un TableAdapter et d'exécuter une requête doit se présenter de la manière suivante (cet exemple suppose que la valeur de retour est un entier ; vous devez donc ajuster votre code selon le type de données retourné par votre requête) :
```
NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = 
    new NorthwindDataSetTableAdapters.CustomersTableAdapter();

int returnValue = (int)tableAdapter.GetCustomerCount();
```
```
Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()

Dim returnValue As Integer
returnValue = CType(tableAdapter.GetCustomerCount(), Integer)
```

Exécution d'instructions SQL qui retournent des valeurs uniques à l'aide d'un objet de commande

L'exemple suivant illustre la création d'une commande et l'exécution d'une instruction SQL qui retourne une valeur unique. Pour plus d'informations sur la définition et l'obtention des valeurs de paramètre pour une commande, consultez Comment : définir et obtenir des paramètres pour des objets de commande.

Cet exemple utilise l'objet SqlCommand et requiert les éléments suivants :

des références aux espaces de noms System, System.Data et System.Xml ;
une connexion de données nommée SqlConnection1 ;
une table nommée Customers dans la source de données à laquelle SqlConnection1 se connecte (sinon, vous avez besoin d'une instruction SQL valide pour votre source de données).

Pour exécuter une instruction SQL qui retourne une valeur unique à l'aide d'un DataCommand

Ajoutez le code suivant à une méthode à partir de laquelle vous souhaitez exécuter le code. Pour retourner une valeur unique, vous devez appeler la méthode ExecuteScalar d'une commande (par exemple, ExecuteScalar). Les données sont retournées dans un Object.

SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
SqlCommand cmd = new SqlCommand();
Object returnValue;

cmd.CommandText = "SELECT COUNT(*) FROM Customers";
cmd.CommandType = CommandType.Text;
cmd.Connection = sqlConnection1;

sqlConnection1.Open();

returnValue = cmd.ExecuteScalar();

sqlConnection1.Close();

Dim sqlConnection1 As New SqlConnection("Your Connection String")
Dim cmd As New SqlCommand
Dim returnValue As Object

cmd.CommandText = "SELECT COUNT(*) FROM Customers"
cmd.CommandType = CommandType.Text
cmd.Connection = sqlConnection1

sqlConnection1.Open()

returnValue = cmd.ExecuteScalar()

sqlConnection1.Close()

Sécurité .NET Framework

L'application requiert l'autorisation d'accéder à la base de données et d'exécuter l'instruction SQL.

Voir aussi

SqlCommand.ExecuteScalar
OleDbCommand.ExecuteScalar
OdbcCommand.ExecuteScalar
OracleCommand.ExecuteScalar
Comment : créer des requêtes TableAdapter
Comment : modifier des requêtes TableAdapter
Comment : remplir de données un groupe de données
Remplissage de groupes de données avec des données
Comment : définir et obtenir des paramètres pour des objets de commande

Partager via