Gewusst wie: Hinzufügen der Schaltflächen für das Laden, Speichern und Abbrechen zum BindingNavigator-Steuerelement in Windows Forms

Aktualisiert: November 2007

Das BindingNavigator-Steuerelement ist ein spezielles ToolStrip-Steuerelement, das für die Navigation und Bearbeitung von Steuerelementen vorgesehen ist, die an Daten gebunden sind.

Da es sich um ein ToolStrip-Steuerelement handelt, kann die BindingNavigator-Komponente problemlos geändert werden, um zusätzliche oder alternative Befehle für den Benutzer bereitzustellen.

In der folgenden Prozedur ist ein TextBox-Steuerelement an Daten gebunden, und das dem Formular hinzugefügte ToolStrip-Steuerelement wird um die Schaltflächen für das Laden, Speichern und Abbrechen ergänzt.

So fügen Sie die Schaltflächen für das Laden, Speichern und Abbrechen der BindingNavigator-Komponente hinzu

1. Fügen Sie dem Formular ein TextBox-Steuerelement hinzu.

2. Binden Sie es an eine BindingSource, die an eine Datenquelle gebunden ist. In diesem Beispiel ist die BindingSource an eine Datenbank gebunden.

3. Nachdem das Dataset und der Tabellenadapter generiert wurden, ziehen Sie ein BindingNavigator-Steuerelement in das Formular.

4. Legen Sie für die BindingSource-Eigenschaft des BindingNavigator-Steuerelements die BindingSource auf dem Formular fest, die an die Steuerelemente gebunden ist.

5. Wählen Sie das BindingNavigator-Steuerelement aus.

6. Klicken Sie auf das Smarttagsymbol (), um das Dialogfeld BindingNavigator-Aufgaben aufzurufen, und wählen Sie Elemente bearbeiten aus.

   Der Elementauflistungs-Editor wird angezeigt.

7. Führen Sie im Elementauflistungs-Editor folgende Schritte aus:

   1. Fügen Sie ein ToolStripSeparator und drei ToolStripButton-Elemente hinzu, indem Sie den entsprechenden ToolStripItem-Typ auswählen und auf die Schaltfläche Hinzufügen klicken.

   2. Legen Sie die Name-Eigenschaft der Schaltflächen auf LoadButton,SaveButton bzw.CancelButton fest.

   3. Legen Sie die Text-Eigenschaft der Schaltflächen aufLoad, Save undCancel fest.

   4. Legen Sie die DisplayStyle-Eigenschaft für jede der Schaltflächen auf Text fest. Wahlweise können Sie diese Eigenschaft aufImageoderImageAndTextfestlegen und das anzuzeigende Bild in der Image-Eigenschaft auswählen.

   5. Klicken Sie auf OK, um das Dialogfeld zu schließen. Die Schaltflächen werden dem ToolStrip hinzugefügt.

8. Klicken Sie mit der rechten Maustaste auf das Formular, und wählen Sie Code anzeigen.

9. Suchen Sie im Code-Editor die Codezeile, mit der Daten in den Tabellenadapter geladen werden. Dieser Code wurde generiert, als Sie die Datenbindung in Schritt 2 eingerichtet haben. Der Code sollte in etwa folgendermaßen aussehen: TableAdapterName.Fill(DataSetName.TableName). Er ist voraussichtlich im Load-Ereignis des Formulars enthalten.

10. Erstellen Sie einen Ereignishandler für das Click-Ereignis des zuvor erstellten ToolStripButtonLoad, und verschieben Sie diesen Code in den Handler.

    Der Code sollte nun ungefähr wie folgt aussehen:

    [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. Erstellen Sie einen Ereignishandler für das Click-Ereignis des zuvor erstellten ToolStripButtonSave, und schreiben Sie Code, um die Daten in der Tabelle, an die das Steuerelement gebunden ist, zu aktualisieren.

    [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);
    }
    

    Hinweis:

    In einigen Fällen verfügt die BindingNavigator-Komponente bereits über die Schaltfläche für das Speichern, allerdings ohne dass Code vom Windows Forms-Designer generiert wurde. In diesem Fall können Sie den voranstehenden Code in den Click-Ereignishandler für diese Schaltfläche einfügen, anstatt eine komplett neue Schaltfläche auf dem ToolStrip zu erstellen. Da die Schaltfläche jedoch standardmäßig deaktiviert ist, müssen Sie die Enabled-Eigenschaft der Schaltfläche auf true festlegen, damit die Schaltfläche ordnungsgemäß funktioniert.

12. Erstellen Sie einen Ereignishandler für das Click-Ereignis des zuvor erstellten ToolStripButtonCancel, und schreiben Sie Code, um Änderungen an dem angezeigten Datensatz zu verwerfen.

    [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();
    }
    

    Hinweis:
    Die CancelEdit-Methode wird auf die Datenzeile beschränkt. Speichern Sie alle Änderungen, die Sie vornehmen, während Sie diesen Datensatz anzeigen, bevor Sie zum nächsten Datensatz navigieren.

Siehe auch

Referenz

Übersicht über die BindingSource-Komponente

BindingNavigator

BindingSource

ToolStrip

Weitere Ressourcen

BindingNavigator-Steuerelement (Windows Forms)