Gewusst wie: Hinzufügen von Validierungen zu einem N-Tier-DataSet

Validierungen werden einem DataSet, das in eine N-Tier-Projektmappe aufgeteilt ist, grundsätzlich auf die gleiche Art hinzugefügt wie einem DataSet in einer einzelnen Datei (in einem einzelnen Projekt). Es wird empfohlen, die Datenvalidierung während des ColumnChanging-Ereignisses und/oder des RowChanging-Ereignisses einer Datentabelle auszuführen.

Vom Erstellen und Bearbeiten von typisierten Datasets wird die Funktionalität zum Erstellen von partiellen Klassen bereitgestellt, zu denen Sie Benutzercode für Spalten- und Zeilenänderungsereignisse der Datentabellen im DataSet hinzufügen können. Weitere Informationen über das Hinzufügen von Code zu einem Dataset in einer N-Tier-Projektmappe finden Sie unter Gewusst wie: Hinzufügen von Code zu DataSets in N-Tier-Anwendungen und Gewusst wie: Hinzufügen von Code zu TableAdapters in N-Tier-Anwendungen. Weitere Informationen zu partiellen Klassen finden Sie unter Gewusst wie: Aufteilen einer Klasse in partielle Klassen (Klassen-Designer) und unter Partielle Klassen und Methoden (C#-Programmierhandbuch).

Validieren von Änderungen in einzelnen Spalten

Validieren Sie die Werte in einzelnen Spalten durch Behandeln des ColumnChanging-Ereignisses. Das ColumnChanging-Ereignis wird ausgelöst, wenn der Wert in einer Spalte geändert wird. Erstellen Sie einen Ereignishandler für das ColumnChanging-Ereignis, indem Sie auf die gewünschte Spalte im Erstellen und Bearbeiten von typisierten Datasets doppelklicken.

Beim ersten Doppelklicken auf eine Spalte wird vom Designer ein Ereignishandler für das ColumnChanging-Ereignis erstellt. Außerdem wird zusätzlich zum ColumnChanging-Ereignis eine If…Then-Anweisung erstellt, von der Tests für die spezifische Spalte ausführt. Der folgende Code wird beispielsweise erstellt, wenn Sie auf die RequiredDate-Spalte der Tabelle Northwind Orders doppelklicken:

Private Sub OrdersDataTable_ColumnChanging(ByVal sender As System.Object, ByVal e As System.Data.DataColumnChangeEventArgs) Handles Me.ColumnChanging
    If (e.Column.ColumnName = Me.RequiredDateColumn.ColumnName) Then
        ' Add validation code here.
    End If
End Sub

So fügen Sie Validierungen bei Änderung einzelner Spaltenwerte hinzu

1. Öffnen Sie das Dataset im Erstellen und Bearbeiten von typisierten Datasets durch Doppelklicken auf die XSD-Datei im Projektmappen-Explorer. Weitere Informationen finden Sie unter Gewusst wie: Öffnen eines Datasets im DataSet-Designer.

2. Doppelklicken Sie auf die zu validierende Spalte. Durch diese Aktion wird der ColumnChanging-Ereignishandler erstellt.

   Hinweis

   Der Dataset-Designer erstellt den Ereignishandler für das C#-Ereignis nicht automatisch.Der zum Behandeln des Ereignisses in C# erforderliche Code wird unten aufgeführt.SampleColumnChangingEvent wird erstellt, und dann wird es in das ColumnChanging-Ereignis in der EndInit-Methode eingebunden.

3. Fügen Sie Code hinzu, mit dem überprüft wird, ob die Daten in e.ProposedValue den Anforderungen der Anwendung entsprechen. Wenn der vorgeschlagene Wert unzulässig ist, legen Sie für die Spalte fest, dass ein Fehler angezeigt wird.

   Das folgende Codebeispiel überprüft, ob die Mengenspalte einen Wert größer 0 enthält. Wenn die Menge kleiner oder gleich 0 ist, wird die Spalte auf einen Fehler festgelegt. Die Else-Klausel löscht den Fehler, wenn die Menge größer 0 ist. Der Code im spaltenändernden Ereignishandler sollte etwa folgendermaßen aussehen:

   If (e.Column.ColumnName = Me.QuantityColumn.ColumnName) Then
       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
   End If
   

   // C#
   // Add this code to the DataTable 
   // partial class.
   
       public override void EndInit()
       {
           base.EndInit();
           // Hook up the ColumnChanging event
           // to call the SampleColumnChangingEvent method.
           ColumnChanging += SampleColumnChangingEvent;
       }
   
       public void SampleColumnChangingEvent(object sender, System.Data.DataColumnChangeEventArgs e)
       {
           if (e.Column.ColumnName == QuantityColumn.ColumnName)
           {
               if ((short)e.ProposedValue <= 0)
               {
                   e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
               }
               else
               {
                   e.Row.SetColumnError("Quantity", "");
               }
           }
       }
   

Validieren von Änderungen an ganzen Zeilen

Überprüfen Sie Werte in ganzen Zeilen durch Behandeln des RowChanging-Ereignisses. Das RowChanging-Ereignis wird ausgelöst, wenn ein Commit für die Werte in allen Spalten ausgeführt wird. Wenn der Wert in einer Spalte von dem Wert in einer anderen Spalte abhängt, ist es erforderlich, dies im RowChanging-Ereignis zu überprüfen. Betrachten Sie beispielsweise OrderDate und RequiredDate in der Tabelle Orders in Northwind. Wenn die Bestellungen eingegeben werden, wird durch die Validierung sichergestellt, dass keine Bestellung mit einem RequiredDate eingegeben wird, das vor dem OrderDate liegt oder mit diesem übereinstimmt. In diesem Beispiel müssen die Werte für die Spalten RequiredDate und OrderDate verglichen werden, es ist daher nicht sinnvoll, eine einzelne Spaltenänderung zu überprüfen.

Erstellen Sie einen Ereignishandler für das RowChanging-Ereignis, indem Sie im Erstellen und Bearbeiten von typisierten Datasets in der Titelleiste der Tabelle auf den Tabellennamen doppelklicken.

So fügen Sie Validierungen bei Änderung ganzer Zeilen hinzu

1. Öffnen Sie das Dataset im Erstellen und Bearbeiten von typisierten Datasets durch Doppelklicken auf die XSD-Datei im Projektmappen-Explorer. Weitere Informationen finden Sie unter Gewusst wie: Öffnen eines Datasets im DataSet-Designer.

2. Doppelklicken Sie im Designer auf die Titelleiste der Datentabelle.

   Eine partielle Klasse wird mit einem RowChanging-Ereignishandler erstellt und im Code-Editor geöffnet.

   Hinweis

   Vom DataSet-Designer wird in C#-Projekten nicht automatisch ein Ereignishandler für das RowChanging-Ereignis erstellt.Sie müssen eine Methode erstellen, mit der Sie das RowChanging-Ereignis behandeln und Code ausführen können, um das Ereignis mit der Initialisierungsmethode der Tabelle zu verknüpfen.

3. Fügen Sie Benutzercode innerhalb der Deklaration der partiellen Klasse hinzu.

4. Im folgenden Code wird für Visual Basic dargestellt, an welcher Stelle während des RowChanging-Ereignisses Benutzercode zur Validierung hinzugefügt werden kann:

   Partial Class OrdersDataTable
       Private Sub OrdersDataTable_OrdersRowChanging(ByVal sender As System.Object, ByVal e As OrdersRowChangeEvent) Handles Me.OrdersRowChanging
           ' Add logic to validate columns here.
           If e.Row.RequiredDate <= e.Row.OrderDate Then
               ' Set the RowError if validation fails.
               e.Row.RowError = "Required Date cannot be on or before the OrderDate"
           Else
               ' Clear the RowError when validation passes.
               e.Row.RowError = ""
           End If
       End Sub
   End Class
   

5. Im folgenden Code wird für C# dargestellt, wie der RowChanging-Ereignishandler erstellt wird und an welcher Stelle während des RowChanging-Ereignisses Benutzercode zur Validierung hinzugefügt werden kann:

   partial class OrdersDataTable
   {
       public override void EndInit()
       {
           base.EndInit();
           // Hook up the event to the
           // RowChangingEvent method.
           OrdersRowChanging += RowChangingEvent;
       }
   
       public void RowChangingEvent(object sender, OrdersRowChangeEvent e)
       {
           // Perfom the validation logic.
           if (e.Row.RequiredDate <= e.Row.OrderDate)
           {
               // Set the row to an error when validation fails.
               e.Row.RowError = "Required Date cannot be on or before the OrderDate";
           }
           else
           {
               // Clear the RowError if validation passes.
               e.Row.RowError = "";
           }
       }
   }
   

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erstellen einer N-Tier-Datenanwendung

Konzepte

Übersicht über N-Tier-Datenanwendungen

Überprüfen von Daten in Datasets