Partager via


Comment : exécuter une procédure stockée qui retourne des lignes

Pour exécuter une procédure stockée qui retourne des lignes, vous pouvez lancer une requête TableAdapter configurée pour exécuter une procédure stockée (par exemple, CustomersTableAdapter.Fill(CustomersDataTable)).

Si votre application n'utilise pas de TableAdapters, appelez la méthode ExecuteReader sur un objet de commande en affectant à sa propriété CommandType la valeur StoredProcedure. ((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 de procédures stockées qui retournent des lignes 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

Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Utilisation des paramètres.

Exécution de procédures stockées qui retournent des lignes à 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 procédure stockée qui retourne des lignes à l'aide d'un TableAdapter

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

  2. S'il n'existe pas encore de TableAdapter, créez-en un. Pour plus d'informations, consultez Comment : créer des TableAdapters.

  3. Si vous disposez déjà dans votre TableAdapter d'une requête appelant une procédure stockée qui retourne des lignes, 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 appelant une procédure stockée qui retourne des lignes.

  4. Cliquez avec le bouton droit sur le TableAdapter de votre choix et utilisez le menu contextuel pour ajouter une requête.

    La Configuration de requête TableAdapter (Assistant) s'ouvre.

  5. Cliquez sur Suivant, puis choisissez Utiliser une procédure stockée existante et cliquez sur Suivant.

  6. Sélectionnez une procédure stockée dans la liste déroulante, puis cliquez sur Suivant.

  7. Conservez la valeur par défaut (Données sous forme de tableau), puis cliquez sur Suivant.

  8. Attribuez un nom à chaque méthode que vous souhaitez créer (méthodes Remplir un DataTable et/ou Retourner un DataTable).

  9. Une fois l'Assistant terminé, la requête est ajoutée au TableAdapter.

  10. Générez votre projet.

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

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

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

    TableAdapter.Query(DataTable, Parameters)

    Le code complet permettant de déclarer une instance du TableAdapter et d'exécuter la requête doit se présenter sous la forme suivante :

    Dim tableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()
    tableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")
    
    NorthwindDataSetTableAdapters.CustomersTableAdapter tableAdapter = 
        new NorthwindDataSetTableAdapters.CustomersTableAdapter();
    
    tableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");
    

Exécution de procédures stockées qui retournent des lignes à l'aide d'un objet de commande

L'exemple suivant illustre la création d'une commande et l'exécution d'une procédure stockée qui retourne des lignes. 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 procédure stockée qui retourne des lignes par programme à l'aide d'un objet de commande

  • Ajoutez le code suivant à une méthode à partir de laquelle vous souhaitez exécuter le code. Pour retourner des lignes, vous devez appeler la méthode ExecuteReader de la commande (par exemple, ExecuteReader). Les données sont retournées dans un DataReader. Pour plus d'informations sur l'accès aux données dans un DataReader, consultez Extraction de données à l'aide d'un DataReader (ADO.NET).

    Dim sqlConnection1 As New SqlConnection("Your Connection String")
    Dim cmd As New SqlCommand
    Dim reader As SqlDataReader
    
    cmd.CommandText = "StoredProcedureName"
    cmd.CommandType = CommandType.StoredProcedure
    cmd.Connection = sqlConnection1
    
    sqlConnection1.Open()
    
    reader = cmd.ExecuteReader()
    ' Data is accessible through the DataReader object here.
    
    sqlConnection1.Close()
    
    SqlConnection sqlConnection1 = new SqlConnection("Your Connection String");
    SqlCommand cmd = new SqlCommand();
    SqlDataReader reader;
    
    cmd.CommandText = "StoredProcedureName";
    cmd.CommandType = CommandType.StoredProcedure;
    cmd.Connection = sqlConnection1;
    
    sqlConnection1.Open();
    
    reader = cmd.ExecuteReader();
    // Data is accessible through the DataReader object here.
    
    sqlConnection1.Close();
    

Sécurité

L'application requiert l'autorisation d'accéder à la base de données et d'exécuter la procédure stockée.

Voir aussi

Tâches

Comment : créer des requêtes TableAdapter

Comment : remplir de données un groupe de données

Comment : définir et obtenir des paramètres pour des objets de commande

Référence

SqlCommand.ExecuteReader

OleDbCommand.ExecuteReader

OdbcCommand.ExecuteReader

OracleCommand.ExecuteReader

Concepts

Remplissage de groupes de données avec des données