Freigeben über

Exemplarische Vorgehensweise: Hinzufügen von Validierung zu einem DataSet

  • Artikel

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird das Validieren von geänderten Daten in einem Dataset veranschaulicht. Die Stelle, an der eine Validierung vorgenommen wird, hängt von den Anforderungen der jeweiligen Anwendung ab. In dieser exemplarischen Vorgehensweise werden Daten beim Ändern der Werte in den einzelnen Spalten validiert. Im folgenden Beispiel wird mithilfe des ColumnChanging-Ereignisses überprüft, ob ein zulässiger Wert in den Datensatz eingegeben wird. Wenn der Wert nicht gültig ist, wird der Benutzer durch die Anzeige eines ErrorProvider-Steuerelements darauf aufmerksam gemacht.

In diesem Beispiel wird veranschaulicht, wie mit dem Dataset-Designer eine partielle Klasse für das Dataset erstellt wird. (Einer partiellen Klasse kann Code zur Erweiterung der Funktionen des von Visual Studio generierten DataSets hinzugefügt werden. Sie wird nicht überschrieben, wenn das Dataset neu generiert wird.)

Hinweis:

Je nach den aktiven Einstellungen oder der verwendeten Version, können die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen abweichen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Zu den Aufgaben in dieser exemplarischen Vorgehensweise gehören:

Vorbereitungsmaßnahmen

Für die Durchführung dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen einer neuen Windows-Anwendung.

So erstellen Sie das neue Windows-Anwendungsprojekt

  1. Erstellen Sie im Menü Datei ein neues Projekt.

  2. Nennen Sie das Projekt ValidationWalkthrough.

  3. Wählen Sie Windows-Anwendung aus, und klicken Sie auf OK. Weitere Informationen finden Sie unter Erstellen von Windows-basierten Anwendungen.

    Das Projekt ValidationWalkthrough wird erstellt und dem Projektmappen-Explorer hinzugefügt.

Erstellen einer neuen Datenquelle aus einer Datenbank

So erstellen Sie die Datenquelle

  1. Klicken Sie im Menü Daten auf Datenquellen anzeigen.

  2. Wählen Sie im Datenquellenfenster die Option Neue Datenquelle hinzufügen aus, um den Assistenten zum Konfigurieren von Datenquellen zu starten.

  3. Wählen Sie auf der Seite Datenquellentyp auswählen die Option Datenbank aus, und klicken Sie dann auf Weiter.

  4. Führen Sie auf der Seite Wählen Sie Ihre Datenverbindung aus einen der folgenden Schritte aus:

    • Wenn eine Datenverbindung zur Beispieldatenbank Northwind in der Dropdownliste verfügbar ist, wählen Sie diese aus.

      – oder –

    • Wählen Sie Neue Verbindung aus, um das Dialogfeld Verbindung hinzufügen/ändern zu öffnen. Weitere Informationen finden Sie unter Dialogfeld "Verbindung hinzufügen/ändern" (Allgemein).

  5. Wenn für die Datenbank ein Kennwort erforderlich ist, aktivieren Sie die Option für die Einbeziehung vertraulicher Daten, und klicken Sie dann auf Weiter.

  6. Klicken Sie auf der Seite Verbindungszeichenfolge in der Programmkonfigurationsdatei speichern auf Weiter.

  7. Erweitern Sie auf der Seite Datenbankobjekte auswählen den Knoten Tabellen.

  8. Wählen Sie die Tabelle Order Details aus, und klicken Sie dann auf Fertig stellen.

    Das NorthwindDataSet wird dem Projekt hinzugefügt, und die Tabelle OrderDetails wird im Datenquellenfenster angezeigt.

Erstellen datengebundener Steuerelemente

So erstellen Sie datengebundene Steuerelemente auf dem Formular

  1. Wählen Sie im Datenquellenfenster die Tabelle Order Details aus.

  2. Wählen Sie aus der Steuerelementliste der Tabelle die Option Details aus.

  3. Ziehen Sie den Knoten Order Details aus dem Datenquellenfenster auf Form1.

    Auf dem Formular werden datengebundene Steuerelemente mit beschreibenden Bezeichnungen sowie ein Toolstrip (BindingNavigator) für die Navigation in den Datensätzen angezeigt. Auf dem Formular werden datengebundene Steuerelemente mit beschreibenden Bezeichnungen sowie ein Toolstrip (BindingNavigator) für die Navigation in den Datensätzen angezeigt. Im Komponentenfach werden jeweils ein NorthwindDataset, Order_DetailsTableAdapter, BindingSource und BindingNavigator angezeigt.

Hinzufügen eines ErrorProvider-Steuerelements zum Formular

So konfigurieren Sie ein ErrorProvider-Steuerelement

  1. Ziehen Sie ein ErrorProvider aus der Toolbox auf Form1.

  2. Legen Sie im Eigenschaftenfenster die DataSource-Eigenschaft des ErrorProvider auf Order_DetailsBindingSource fest.

    Hinweis:

    Legen Sie die DataMember-Eigenschaft nicht fest.

Erstellen des ColumnChanging-Ereignishandlers

So erstellen Sie die Validierungsereignishandler

  1. Öffnen Sie das NorthwindDataset im Dataset Designer, indem Sie im Projektmappen-Explorer auf die Datei NorthwindDataSet.xsd doppelklicken.

  2. Doppelklicken Sie in der Tabelle OrderDetails auf die Spalte Quantity, um den OrderDetailsDataTable_ColumnChanging-Ereignishandler zu erstellen. (In C# wird nur die partielle Klasse der Datentabelle erstellt.)

    Hinweis:

    Beim Doppelklicken auf den Tabellennamen (Order Details in der Titelleiste) wird ein Handler für das RowChanging-Ereignis erstellt.

  3. Fügen Sie Code ein, im dem überprüft wird, ob e.ProposedValue Werte enthält, die größer als 0 (null) sind. Wenn der vorgeschlagene Wert gleich oder kleiner als 0 (null) ist, markieren Sie die Spalte, um anzuzeigen, dass sie einen Fehler enthält.

    Fügen Sie den folgenden Code im column-changing-Ereignishandler unter dem Kommentar Add user code here ein:

    If CType(e.ProposedValue, Short) <= 0 Then
        e.Row.SetColumnError(e.Column, "Quantity must be greater than 0")
    Else
        e.Row.SetColumnError(e.Column, "")
End If

    // C#
// Add the following code 
// to the partial class.
    public override void EndInit()
    {
        base.EndInit();
        Order_DetailsRowChanging += TestRowChangeEvent;
    }

    public void TestRowChangeEvent(object sender, Order_DetailsRowChangeEvent e)
    {
        if ((short)e.Row.Quantity <= 0)
        {
            e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
        }
        else
        {
            e.Row.SetColumnError("Quantity", "");
        }
    }

Testen der Anwendung

So testen Sie die Anwendung

  1. Drücken Sie F5, um die Anwendung auszuführen.

  2. Ändern Sie den Wert im Textfeld Quantity in 0 (null).

  3. Drücken Sie die TAB-Taste, um den Fokus aus dem Textfeld zu verschieben.

    Das ErrorProvider-Symbol wird angezeigt.

  4. Positionieren Sie den Mauszeiger über dem ErrorProvider-Symbol, um die Meldung anzuzeigen.

Nächste Schritte

Nach dem Hinzufügen einer Validierung sollten Sie, je nach den Anforderungen der Anwendung, einen der folgenden Schritte ausführen. Sie können an dieser exemplarischen Vorgehensweise beispielsweise folgende Verbesserungen vornehmen:

Siehe auch

Konzepte

Neue Datenfeatures

Übersicht über das Anzeigen von Daten

Weitere Ressourcen

Exemplarische Vorgehensweisen zur Arbeit mit Daten

Herstellen von Datenverbindungen in Visual Studio

Vorbereiten der Anwendung auf den Empfang von Daten

Abrufen von Daten für die Anwendung

Anzeigen von Daten in Formularen in Windows-Anwendungen

Bearbeiten von Daten in der Anwendung

Überprüfen von Daten

Speichern von Daten