Überprüfen von Daten in Datasets in .NET Framework-Anwendungen

Die Überprüfung von Daten ist der Prozess der Bestätigung, dass die in Datenobjekte eingegebenen Werte den Einschränkungen im Schema eines Datasets entsprechen. Der Überprüfungsprozess bestätigt außerdem, dass diese Werte den Regeln folgen, die für Ihre Anwendung eingerichtet wurden. Es empfiehlt sich, Daten vor dem Senden von Aktualisierungen an die zugrunde liegende Datenbank zu überprüfen. Dadurch werden Fehler sowie die potenzielle Anzahl von Roundtrips zwischen einer Anwendung und der Datenbank reduziert.

Sie können sich vergewissern, dass die Daten, die in ein Dataset geschrieben werden, gültig sind, indem Sie Überprüfungen in das Dataset selbst integrieren. Das Dataset kann die Daten unabhängig davon überprüfen, wie die Aktualisierung durchgeführt wird – ob direkt durch Steuerelemente in einem Formular, innerhalb einer Komponente oder auf andere Weise. Da das Dataset Teil Ihrer Anwendung ist (im Gegensatz zum Back-End der Datenbank), ist es ein logischer Ort, um eine anwendungsspezifische Überprüfung zu erstellen.

Am besten fügen Sie die Überprüfung in Ihre Anwendung in der partiellen Klassendatei des Datasets ein. Öffnen Sie in Visual Basic oder Visual C# den DataSet-Designer, und doppelklicken Sie auf die Spalte oder Tabelle, für die Sie eine Überprüfung erstellen möchten. Diese Aktion öffnet die Codedatei, in der Sie einen ColumnChanging- oder RowChanging-Ereignishandler erstellen können.

private static void OnColumnChanging(object sender, DataColumnChangeEventArgs e)
{

}

Private Shared Sub OnColumnChanging(sender As Object, e As DataColumnChangeEventArgs)

End Sub

Überprüfen von Daten

Die Überprüfung innerhalb eines Datasets erfolgt auf folgende Weise:

• Durch Erstellen einer eigenen anwendungsspezifischen Überprüfung, die Werte in einer einzelnen Datenspalte bei Änderungen überprüfen kann. Weitere Informationen finden Sie unter Gewusst wie: Überprüfen von Daten während Spaltenänderungen.

• Durch Erstellen einer eigenen anwendungsspezifischen Überprüfung, die Daten auf Werte überprüfen kann, während sich eine ganze Datenzeile ändert. Weitere Informationen finden Sie unter Gewusst wie: Überprüfen von Daten während Zeilenänderungen.

• Durch das Erstellen von Schlüsseln, eindeutigen Einschränkungen usw. als Teil der tatsächlichen Schemadefinition des Datasets.

• Durch Festlegen der Eigenschaften des DataColumn-Objekts, z. B. MaxLength, AllowDBNull und Unique.

Mehrere Ereignisse werden vom DataTable-Objekt ausgelöst, wenn eine Änderung in einem Datensatz auftritt:

• Die Ereignisse ColumnChanging und ColumnChanged werden während und nach jeder Änderung an einer einzelnen Spalte ausgelöst. Das ColumnChanging-Ereignis ist nützlich, wenn Sie Änderungen in bestimmten Spalten überprüfen möchten. Informationen zur vorgeschlagenen Änderung werden als Argument mit dem Ereignis übergeben.
• Die Ereignisse RowChanging und RowChanged werden während und nach jeder Änderung in einer Zeile ausgelöst. Das RowChanging-Ereignis ist allgemeiner. Es weist darauf hin, dass eine Änderung an einer beliebigen Stelle in der Zeile erfolgt, aber Sie wissen nicht, welche Spalte geändert wurde.

Standardmäßig löst jede Änderung in einer Spalte daher vier Ereignisse aus. Die ersten sind die ColumnChanging- und ColumnChanged-Ereignisse für die bestimmte Spalte, die geändert wird. Als nächstes folgen die Ereignisse RowChanging und RowChanged. Wenn an der Zeile mehrere Änderungen vorgenommen werden, werden die Ereignisse für jede Änderung ausgelöst.

Das von Ihnen ausgewählte Ereignis hängt davon ab, wie präzise die Überprüfung sein soll. Wenn es wichtig ist, dass Sie einen Fehler sofort abfangen, wenn eine Spalte geändert wird, erstellen Sie die Überprüfung mithilfe des ColumnChanging-Ereignisses. Verwenden Sie andernfalls das RowChanging-Ereignis, das dazu führen kann, dass mehrere Fehler gleichzeitig abgefangen werden. Wenn Ihre Daten so strukturiert sind, dass der Wert einer Spalte basierend auf dem Inhalt einer anderen Spalte überprüft wird, führen Sie ihre Überprüfung während des RowChanging-Ereignisses durch.

Wenn Datensätze aktualisiert werden, löst das DataTable-Objekt Ereignisse aus, auf die Sie reagieren können, während und nachdem die Änderungen vorgenommen werden.

Wenn Ihre Anwendung ein typisiertes Dataset verwendet, können Sie stark typisierte Ereignishandler erstellen. Dies fügt vier zusätzliche typisierte Ereignisse hinzu, für die Sie Handler erstellen können: dataTableNameRowChanging, dataTableNameRowChanged, dataTableNameRowDeleting und dataTableNameRowDeleted. Diese typisierten Ereignishandler übergeben ein Argument, das die Spaltennamen Ihrer Tabelle enthält und das Schreiben und Lesen von Code erleichtert.

Datenaktualisierungsereignisse

Die Ereignisse ColumnChanging, RowChanging und RowDeleting werden während des Aktualisierungsprozesses ausgelöst. Sie können diese Ereignisse verwenden, um Daten zu überprüfen oder andere Arten der Verarbeitung durchzuführen. Da die Aktualisierung während dieser Ereignisse im Gange ist, können Sie sie abbrechen, indem Sie eine Ausnahme auslösen, die verhindert, dass die Aktualisierung abgeschlossen wird.

Die Ereignisse ColumnChanged, RowChanged und RowDeleted sind Benachrichtigungsereignisse, die ausgelöst werden, wenn die Aktualisierung erfolgreich abgeschlossen wurde. Diese Ereignisse sind nützlich, wenn Sie basierend auf einer erfolgreichen Aktualisierung weitere Maßnahmen ergreifen möchten.

Überprüfen von Daten während Spaltenänderungen

Sie können Daten überprüfen, wenn sich der Wert in einer Datenspalte ändert, indem Sie auf das ColumnChanging-Ereignis reagieren. Wenn dieses Ereignis ausgelöst wird, übergibt es ein Ereignisargument (ProposedValue), das den Wert enthält, der für die aktuelle Spalte vorgeschlagen wird. Basierend auf dem Inhalt von e.ProposedValue haben Sie folgende Möglichkeiten:

• Den vorgeschlagenen Wert annehmen, indem Sie nichts tun.

• Den vorgeschlagenen Wert ablehnen, indem Sie innerhalb des Ereignishandlers für Spaltenänderungen den Spaltenfehler festlegen (SetColumnError).

• Optional können Sie ein ErrorProvider-Steuerelement verwenden, um dem Benutzer eine Fehlermeldung anzuzeigen. Weitere Informationen finden Sie unter ErrorProvider Component (ErrorProvider-Komponente).

Die Überprüfung kann auch während des RowChanging-Ereignisses durchgeführt werden.

Überprüfen von Daten während Zeilenänderungen

Sie können Code schreiben, um sicherzustellen, dass alle zu validierenden Spalten Daten enthalten, die den Anforderungen der Anwendung entsprechen. Legen Sie dazu die Spalte fest, um anzugeben, dass sie einen Fehler enthält, wenn ein vorgeschlagener Wert inakzeptabel ist. In den folgenden Beispielen wird ein Spaltenfehler festgelegt, wenn für die Quantity-Spalte ein Wert von 0 oder weniger gilt. Die Ereignishandler für Zeilenänderungen sollten den folgenden Beispielen entsprechen.

So validieren Sie Daten bei Zeilenänderungen (Visual Basic)

1. Öffnen Sie das Dataset im DataSet-Designer. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Datasets im DataSet-Designer.

2. Doppelklicken Sie auf die Titelleiste der zu validierenden Tabelle. Durch diese Aktion wird der RowChanging-Ereignishandler der DataTable in der Datei für die partielle Klasse des Datasets automatisch erstellt.

   Tipp

   Doppelklicken Sie links neben den Tabellennamen, um den Ereignishandler für Zeilenänderungen zu erstellen. Wenn Sie auf den Tabellennamen doppelklicken, können Sie ihn bearbeiten.

   Private Sub Order_DetailsDataTable_Order_DetailsRowChanging(
       ByVal sender As System.Object, 
       ByVal e As Order_DetailsRowChangeEvent
     ) Handles Me.Order_DetailsRowChanging
   
       If CType(e.Row.Quantity, Short) <= 0 Then
           e.Row.SetColumnError("Quantity", "Quantity must be greater than 0")
       Else
           e.Row.SetColumnError("Quantity", "")
       End If
   End Sub
   

So validieren Sie Daten bei Zeilenänderungen (C#)

1. Öffnen Sie das Dataset im DataSet-Designer. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines Datasets im DataSet-Designer.

2. Doppelklicken Sie auf die Titelleiste der zu validierenden Tabelle. Durch diese Aktion wird eine Datei für die partielle Klasse der DataTable erstellt.

   Hinweis

   Der DataSet-Designer erstellt nicht automatisch einen Ereignishandler für das RowChanging-Ereignis. 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. Kopieren Sie den folgenden Code in die partielle Klasse:

   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", "");
       }
   }
   

So rufen Sie geänderte Zeilen ab

Jede Zeile in einer Datentabelle verfügt über eine RowState-Eigenschaft, die den aktuellen Zustand dieser Zeile mithilfe der Werte in der DataRowState-Enumeration nachverfolgt. Sie können geänderte Zeilen aus einem Dataset oder einer Datentabelle zurückgeben, indem Sie die GetChanges-Methode eines DataSet oder einer DataTable aufrufen. Sie können überprüfen, ob Änderungen vorhanden sind, bevor Sie GetChanges aufrufen, indem Sie die HasChanges-Methode eines Datasets aufrufen.

Durch Aufrufen der GetChanges-Methode eines Datasets oder einer Datentabelle wird ein neues Dataset oder eine neue Datentabelle zurückgegeben, die nur Datensätze enthält, die geändert wurden. Wenn Sie bestimmte Datensätze abrufen möchten, z. B. nur neue oder nur geänderte Datensätze, können Sie einen Wert aus der DataRowState-Enumeration als Parameter an die GetChanges-Methode übergeben.

Verwenden Sie die DataRowVersion-Enumeration, um auf die verschiedenen Versionen einer Zeile zuzugreifen (z. B. die ursprünglichen Werte, die sich vor der Verarbeitung in einer Zeile befanden).

So rufen Sie alle geänderten Datensätze aus einem Dataset ab

• Rufen Sie die GetChanges-Methode eines Datasets auf.

  Im folgenden Beispiel wird ein neues Dataset namens changedRecords erstellt und mit allen geänderten Datensätzen aus einem anderen Dataset namens dataSet1 aufgefüllt.

  • C#
  • VB

  DataSet changedRecords = dataSet1.GetChanges();
  

So rufen Sie alle geänderten Datensätze aus einer Datentabelle ab

• Rufen Sie die GetChanges-Methode einer Datentabelle auf.

  Im folgenden Beispiel wird eine neue Datentabelle namens changedRecordsTable erstellt und mit allen geänderten Datensätzen aus einer anderen Datentabelle namens dataTable1 aufgefüllt.

  • C#
  • VB

  DataTable changedRecordsTable = dataTable1.GetChanges();
  

So rufen Sie alle Datensätze ab, die einen bestimmten Zeilenzustand aufweisen

• Rufen Sie die GetChanges-Methode eines Datasets oder einer Datentabelle auf, und übergeben Sie einen DataRowState-Enumerationswert als Argument.

  Das folgende Beispiel zeigt, wie Sie ein neues Dataset namens addedRecords erstellen und es nur mit Datensätzen auffüllen, die dem dataSet1-Dataset hinzugefügt wurden.

  • C#
  • VB

  DataSet addedRecords = dataSet1.GetChanges(DataRowState.Added);
  

  Das folgende Beispiel zeigt, wie alle Datensätze zurückgegeben werden, die der Tabelle Customers kürzlich hinzugefügt wurden:

  • C#
  • VB

  private NorthwindDataSet.CustomersDataTable GetNewRecords()
  {
      return (NorthwindDataSet.CustomersDataTable)
          northwindDataSet1.Customers.GetChanges(DataRowState.Added);
  }
  

Zugreifen auf die ursprüngliche Version einer Datenzeile

Wenn an Datenzeilen Änderungen vorgenommen werden, werden im Dataset sowohl die ursprüngliche (Original) als auch die neue (Current) Version der Zeile beibehalten. Vor dem Aufruf der AcceptChanges-Methode kann die Anwendung z. B. auf die verschiedenen (in der DataRowVersion-Enumeration definierten) Versionen eines Datensatzes zugreifen und die Änderungen entsprechend verarbeiten.

Wenn Sie den DataRowVersion-Wert zusammen mit dem Spaltenindex (oder dem Spaltennamen als Zeichenfolge) übergeben, wird der Wert der spezifischen Zeilenversion aus dieser Spalte zurückgegeben. Die geänderte Spalte wird während der Ereignisse ColumnChanging und ColumnChanged identifiziert. Dies ist ein guter Zeitpunkt, um die verschiedenen Zeilenversionen zu Validierungszwecken zu überprüfen. Wenn Sie Einschränkungen jedoch vorübergehend deaktiviert haben, werden diese Ereignisse nicht ausgelöst, sodass die geänderten Spalten programmgesteuert ermittelt werden müssen. Sie können dazu die Columns-Auflistung durchlaufen und die unterschiedlichen DataRowVersion-Werte vergleichen.

So rufen Sie die ursprüngliche Datensatzversion ab

• Greifen Sie auf den Wert einer Spalte zu, und übergeben Sie die DataRowVersion der Zeile, die zurückgegeben werden soll.

  Das folgende Beispiel veranschaulicht, wie Sie mithilfe eines DataRowVersion-Werts den ursprünglichen Wert eines CompanyName-Felds in einer DataRow abrufen:

  • C#
  • VB

  string originalCompanyName;
  originalCompanyName = northwindDataSet1.Customers[0]
      ["CompanyName", DataRowVersion.Original].ToString();
  

Zugreifen auf die aktuelle Version einer Datenzeile

So rufen Sie die aktuelle Datensatzversion ab

• Greifen Sie auf einen Spaltenwert zu, und fügen Sie dann dem Index einen Parameter hinzu, durch den die zurückzugebende Zeilenversion angegeben wird.

  Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe eines DataRowVersion-Werts den aktuellen Wert eines CompanyName-Felds in einer DataRow abrufen:

  • C#
  • VB

  string currentCompanyName;
  currentCompanyName = northwindDataSet1.Customers[0]
      ["CompanyName", DataRowVersion.Current].ToString();
  

Zugehöriger Inhalt

• Datasettools in Visual Studio
• Vorgehensweise: Überprüfen von Daten im DataGridView-Steuerelement in Windows Forms
• Vorgehensweise: Anzeigen von Fehlersymbolen für die Formularvalidierung mit der ErrorProvider-Komponente in Windows Forms