Partager via

Comment : ajouter des boutons Charger, Enregistrer et Annuler au contrôle BindingNavigator Windows Forms

  • Article

Le contrôle BindingNavigator est un contrôle ToolStrip spécial destiné à la navigation et à la manipulation des contrôles de votre formulaire qui sont liés aux données.

Dans la mesure où il s'agit d'un contrôle ToolStrip, le composant BindingNavigator peut être modifié facilement pour inclure des commandes supplémentaires ou alternatives pour l'utilisateur.

Dans la procédure suivante, un contrôle TextBox est lié aux données, et le contrôle ToolStrip jouté au formulaire est modifié pour intégrer des boutons de chargement, d'enregistrement et d'annulation.

Pour ajouter des boutons de chargement, d'enregistrement et d'annulation au composant BindingNavigator

  1. Ajoutez un contrôle TextBox à votre formulaire.

  2. Liez-le à un BindingSource, qui est lié à une source de données. Pour cet exemple, le BindingSource est lié à une base de données.

  3. Après la génération du groupe de données et de l'adaptateur de table, faites glisser un contrôle BindingNavigator jusqu'au formulaire.

  4. Attribuez à la propriété BindingSource du contrôle BindingNavigator la valeur BindingSource sur le formulaire qui est lié aux contrôles.

  5. Sélectionnez le contrôle BindingNavigator.

  6. Cliquez sur le glyphe de balise active (Glyphe de balise active) afin que la boîte de dialogue Tâches BindingNavigator apparaisse, puis sélectionnez Modifier les éléments.

    Vous voyez s'afficher l'éditeur de collections Items.

  7. Dans l'éditeur de collections Items, tapez le texte suivant :

    1. Ajoutez un ToolStripSeparator et trois éléments ToolStripButton en sélectionnant le type approprié de ToolStripItem et cliquant sur le bouton Ajouter.

    2. Attribuez à la propriété Name des boutons les valeurs LoadButton, SaveButton et CancelButton, respectivement.

    3. Attribuez à la propriété Text des boutons les valeurs Load (charger), Save (enregistrer) et Cancel (annuler).

    4. Attribuez à la propriété DisplayStyle de chacun des boutons la valeur Text (texte). Vous pouvez également attribuer à cette propriété la valeur Image ou ImageAndText et définir l'image à afficher dans la propriété Image.

    5. Cliquez sur OK pour fermer la boîte de dialogue. Les boutons sont ajoutés au ToolStrip.

  8. Cliquez avec le bouton droit sur le formulaire et choisissez Afficher le code.

  9. Dans l'éditeur de code, recherchez la ligne de code qui charge des données dans l'adaptateur de table. Ce code a été généré lorsque vous installez la liaison de données à l'étape 2. Le code doit se présenter comme suit : TableAdapterName.Fill(DataSetName.TableName). Il figurera très probablement dans l'événement Load du formulaire.

  10. Créez un gestionnaire d'événements pour l'événement ClickLoadToolStripButton que vous avez créé précédemment et déplacez-y ce code de chargement de données.

    Votre code doit ressembler au suivant :

    [Visual Basic]

    Private Sub LoadButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles LoadButton.Click
    TableAdapterName.Fill(DataSetName.TableName)
End Sub

    [C#]

    private void LoadButton_Click(System.Object sender, 
    System.EventArgs e)
{
    TableAdapterName.Fill(DataSetName.TableName);
}

  11. Créez un gestionnaire d'événements pour l'événement ClickEnregistrerToolStripButton que vous avez créé précédemment et écrivez le code pour mettre à jour les données dans la table à laquelle le contrôle est lié.

    [Visual Basic]

    Private Sub SaveButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles SaveButton.Click
    TableAdapterName.Update(DataSetName.TableName)
End Sub

    [C#]

    private void SaveButton_Click(System.Object sender, 
    System.EventArgs e)
{
    TableAdapterName.Update(DataSetName.TableName);
}

    Notes

    Dans certains cas, le composant BindingNavigator aura déjà un bouton Enregistrer, mais aucun code n'aura été généré par le Concepteur Windows Forms. Dans ce cas, vous pouvez placer le code précédent dans le gestionnaire d'événements Click de ce bouton, au lieu de créer un bouton entièrement nouveau sur le ToolStrip. Toutefois, le bouton étant désactivé par défaut, vous devez attribuer à la propriété Enabled du bouton la valeur true pour que le bouton fonctionne correctement.

  12. Créez un gestionnaire d'événements pour l'événement ClickAnnulerToolStripButton que vous avez créé précédemment et écrivez le code pour annuler toutes les modifications apportées à l'enregistrement des données qui est affiché.

    [Visual Basic]

    Private Sub CancelButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CancelButton.Click
    BindingSourceName.CancelEdit()
End Sub

    [C#]

    private void CancelButton_Click(System.Object sender, System.EventArgs e)
{
    BindingSourceName.CancelEdit();
}

    Notes

    La méthode CancelEdit à une portée qui couvre la ligne de données. Enregistrez toutes les modifications que vous apportez en consultant cet enregistrement individuel avant de naviguer jusqu'à l'enregistrement suivant.

Voir aussi

Référence

Vue d'ensemble du composant BindingSource

BindingNavigator

BindingSource

ToolStrip

Autres ressources

BindingNavigator, contrôle (Windows Forms)