Procédure pas à pas : passage de données entre formulaires dans une application Windows

  • Article

Mise à jour : novembre 2007

Cette procédure pas à pas fournit des instructions détaillées sur le passage de données d'un formulaire à l'autre. À l'aide des tables Customers et Orders de Northwind, un formulaire permet aux utilisateurs de sélectionner un client et un autre formulaire affiche les commandes du client sélectionné. Cette procédure pas à pas montre comment créer une méthode sur un formulaire qui reçoit des données du premier formulaire.

Remarque :

Il ne s'agit là que d'une manière de passer des données entre des formulaires. Il existe d'autres méthodes permettant de passer des données à un formulaire, notamment : créer un deuxième constructeur pour recevoir les données, ou créer une propriété publique qui peut être définie avec les données du premier formulaire.

Cette procédure pas à pas illustre les tâches suivantes :

Composants requis

Pour exécuter cette procédure pas à pas, vous devez utiliser :

Création de l'application Windows

Pour créer le nouveau projet Windows

  1. Dans le menu Fichier, créez un nouveau projet.

  2. Nommez le projet PassingDataBetweenForms.

  3. Sélectionnez Application Windows, puis cliquez sur OK. Pour plus d'informations, consultez Création d'applications Windows.

    Le projet PassingDataBetweenForms est créé et ajouté à l'Explorateur de solutions.

Création de la source de données

Pour créer la source de données

  1. Dans le menu Données, cliquez sur Afficher les sources de données.

  2. Dans la fenêtre Sources de données, sélectionnez Ajouter une nouvelle source de données pour démarrer l'Assistant Configuration de source de données.

  3. Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.

  4. Sur la page Choisir votre connexion de données, effectuez l'une des opérations suivantes :

    • Si une connexion de données à l'exemple de base de données Northwind est disponible dans la liste déroulante, sélectionnez-la.

      - ou -

    • Sélectionnez Nouvelle connexion pour afficher la boîte de dialogue Ajouter/Modifier la connexion. Pour plus d'informations, consultez Ajouter/Modifier une connexion, boîte de dialogue (Général).

  5. Si votre base de données exige un mot de passe et si l'option d'ajout des données sensibles est activée, sélectionnez l'option, puis cliquez sur Suivant.

  6. Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.

  7. Développez le nœud Tables dans la page Choisir vos objets de base de données.

  8. Sélectionnez les tables Customers et Orders, puis cliquez sur Terminer.

    NorthwindDataSet est ajouté à votre projet et les tables Customers et Orders apparaissent dans la fenêtre Sources de données.

Création du premier formulaire (Form1)

Vous pouvez créer une grille liée aux données (contrôle DataGridView) en faisant glisser le nœud Customers depuis la fenêtre Sources de données jusqu'au formulaire.

Pour créer une grille liée aux données sur le formulaire

Création du deuxième formulaire (Form2)

Pour créer un deuxième formulaire auquel passer les données

  1. Dans le menu Projet, choisissez Ajouter un formulaire Windows.

  2. Conservez le nom par défaut de Form2 et cliquez sur Ajoutez.

  3. Faites glisser le nœud Orders depuis la fenêtre Sources de données vers Form2.

    Un DataGridView et une barre d'outils (BindingNavigator) pour parcourir les enregistrements apparaissent sur Form2. Un NorthwindDataSet, un CustomersTableAdapter, un BindingSource et un BindingNavigator apparaissent dans la barre d'état des composants.

  4. Supprimez OrdersBindingNavigator de la barre d'état des composants.

    OrdersBindingNavigator disparaît de Form2.

Ajout d'une requête TableAdapter à Form2 pour charger les commandes du client sélectionné sur Form1

Pour créer une requête TableAdapter

  1. Double-cliquez sur le fichier NorthwindDataSet.xsd dans l'Explorateur de solutions.

  2. Cliquez avec le bouton droit sur le OrdersTableAdapter et sélectionnez Ajouter une requête.

  3. Conservez l'option par défaut (Utiliser des instructions SQL), puis cliquez sur Suivant.

  4. Conservez l'option par défaut (SELECT qui retourne des lignes), puis cliquez sur Suivant.

  5. Ajoutez une clause WHERE à la requête pour retourner les commandes (Orders) en se basant sur le CustomerID. La requête doit se présenter sous la forme suivante :

    SELECT OrderID, CustomerID, EmployeeID, OrderDate, RequiredDate, ShippedDate, ShipVia, Freight, ShipName, ShipAddress, ShipCity, ShipRegion, ShipPostalCode, ShipCountry
FROM Orders 
WHERE CustomerID = @CustomerID
    Remarque :

    Vérifiez si la syntaxe des paramètres est correcte pour votre base de données. Par exemple, dans Microsoft Access, la clause WHERE se présente comme suit : WHERE CustomerID = ?.

  6. Cliquez sur Suivant.

  7. Dans Remplir un DataTable, tapez FillByCustomerID comme Nom de la méthode.

  8. Désactivez l'option Retourner un DataTable, puis cliquez sur Suivant.

  9. Cliquez sur Terminer.

Création sur Form2 d'une méthode à laquelle passer des données

Pour créer une méthode à laquelle passer des données

  1. Cliquez avec le bouton droit sur Form2 et sélectionnez Afficher le code pour ouvrir Form2 dans l'Éditeur de code.

  2. Remplacez la méthode Form2_Load qui a été ajoutée automatiquement au formulaire par le code suivant :

    Friend Sub LoadOrders(ByVal CustomerID As String)
    OrdersTableAdapter.FillByCustomerID(NorthwindDataSet.Orders, CustomerID)
End Sub

    internal void LoadOrders(String CustomerID)
{
    ordersTableAdapter.FillByCustomerID(northwindDataSet.Orders, CustomerID);
}

Création sur Form1 d'une méthode permettant de passer des données et d'afficher Form2

Pour créer une méthode permettant de passer des données à Form2

  1. Cliquez avec le bouton droit sur Form1 et sélectionnez Afficher le code pour ouvrir Form1 dans l'Éditeur de code.

  2. Ajoutez le code suivant à Form1 sous la méthode Form1_Load :

    Private Sub CustomersDataGridView_DoubleClick(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles CustomersDataGridView.DoubleClick

    Dim SelectedRowView As Data.DataRowView
    Dim SelectedRow As NorthwindDataSet.CustomersRow

    SelectedRowView = CType(CustomersBindingSource.Current, System.Data.DataRowView)
    SelectedRow = CType(SelectedRowView.Row, NorthwindDataSet.CustomersRow)

    Dim OrdersForm As New Form2
    OrdersForm.LoadOrders(SelectedRow.CustomerID)
    OrdersForm.Show()
End Sub

    private void customersDataGridView_DoubleClick(object sender, EventArgs e)
{
    System.Data.DataRowView SelectedRowView;
    NorthwindDataSet.CustomersRow SelectedRow;

    SelectedRowView = (System.Data.DataRowView)customersBindingSource.Current;
    SelectedRow = (NorthwindDataSet.CustomersRow)SelectedRowView.Row;

    Form2 OrdersForm = new Form2();
    OrdersForm.LoadOrders(SelectedRow.CustomerID);
    OrdersForm.Show();
}

Exécution de l'application

Pour exécuter l'application

  • Appuyez sur F5 pour exécuter l'application.

  • Double-cliquez sur un enregistrement de client dans Form1 pour ouvrir Form2 avec les commandes de ce client.

Étapes suivantes

Selon les exigences de votre application, vous pouvez exécuter différentes étapes après le passage de données entre formulaires. Vous pouvez apporter à cette procédure pas à pas les améliorations suivantes :

Voir aussi

Concepts

Vue d'ensemble de l'affichage des données

Vue d'ensemble des sources de données

Vue d'ensemble de TableAdapter

Autres ressources

Procédures pas à pas relatives aux données

Connexion aux données dans Visual Studio

Préparation de votre application pour recevoir des données

Extraction de données dans votre application

Affichage des données sur des formulaires dans les applications Windows

Modification des données dans votre application

Validation des données

Enregistrement des données