![\"Beispiel](\"..\/fileadmin\/_temp_\/2016_06\/pic_67_001.png\")
<\/p>\nDie Validierung bei der Eingabe von Daten ist eines der wichtigsten Themen bei der Erstellung benutzerfreundlicher Anwendungen. Nachdem der Artikel “EDM: Ausnahmen beim Speichern behandeln” gezeigt hat, wozu Sie im Rahmen der Validierung die durch Restriktionen im Datenmodell auftretenden Exceptions nutzen können, schauen wir uns nun einen einfachen Weg an, um Validierungsregeln in Entitätsklassen zu definieren und beim Fehlschlagen der Validierung entsprechende Meldungen in der Benutzeroberfläche auszugeben. Dabei zeigen wir hier den Umgang mit der Schnittstelle “IDataErrorInfo”.<\/b><\/p>\nBeispielanwendung<\/h2>\n
Wie im oben genannten Artikel nutzen wir wieder die Beispielanwendung Bestellverwaltung<\/b>. Bevor die im Datenmodell dieser Anwendung festgelegten Restriktionen greifen und bei Fehleingaben Exceptions auslösen, wollen wir Validierungen programmieren, um Fehleingaben des Benutzers zu vermeiden. In diesem Fall schauen wir uns die Seite Kundendetails.xaml.cs <\/b>an, um die Programmierung der Validierung zu veranschaulichen. Dies soll im Ergebnis wie in Bild 1 aussehen.<\/p>\n
<\/p>\n
Bild 1: Beispiel für eine einfache Validierungsmeldung<\/span><\/b><\/p>\n Die hier vorgestellten Techniken zur Validierung von Benutzereingaben beziehen sich auf die Untersuchung der jeweiligen Entität – ist ein Wert in einem Feld mit einem eindeutigen Index bereits vorhanden Darf ein Feld überhaupt leer sein Hat der Benutzer auch ein gültiges Datum eingegeben Liegt der Zahlenwert im zulässigen Bereich<\/p>\n Validierungen können Sie auf mehrere Arten durchführen. Der Artikel EDM: Ausnahmen beim Speichern behandeln zeigt, wie Sie erst beim Auftreten von Fehlern beim Speichern auf fehlerhafte Eingaben des Benutzers reagieren können. Davor gibt es noch mindestens zwei weitere Methoden:<\/p>\n In diesem Artikel schauen wir uns die einfachere Validierung direkt nach der Eingabe eines Wertes an.<\/p>\n Für den Benutzer hat dies beispielsweise den Vorteil, dass er Fehleingaben direkt erkennt und diese direkt korrigieren kann.<\/p>\n In vielen Fällen reicht eine einfache Validierung der Eingaben für Steuerelemente aus. Damit meinen wir, dass nur die Werte einzelner Steuerelemente geprüft werden sollen, und zwar direkt nach der Eingabe. So können Sie beispielsweise abfragen, ob ein Wert eine bestimmte Mindestlänge erreicht, und bei Nichterfüllung dieser Vorgabe einen optischen Hinweis einblenden. Dieser Artikel zeigt, wie Sie eine solche Validierung zu einer Anwendung hinzufügen können.<\/p>\n Die Beispielanwendung heißt Bestellverwaltung. Die im Fenster MainWindow eingeblendete Seite Kundendetails.xaml soll zeigen, wie Sie die hier vorgestellte Art der Validierung implementieren.<\/p>\n Die Validierung mit der hier vorgestellten Methode geschieht immer gleich nach dem Abschluss der Eingabe in ein Feld. Sie löst dann die Anzeige des Steuerelements mit der fehlerhaften Eingabe mit rotem Rahmen und mit einem Warnsymbol aus. Das Überfahren des Warnsymbols mit der Maus führt zur Anzeige eines ToolTip-Textes, der weitere Informationen zum vorliegenden Fehler liefert.<\/p>\n Die Validierung basiert auf zwei verschiedenen Elementen. Das erste Element ist die Klasse, welche die Entität der zu validierenden Objekte beschreibt, in unserem Fall also etwa Kunde.cs. Hier legen wir in Form einer Methode die Regeln fest, nach denen das soeben geänderte Steuerelement geprüft werden soll. Damit erhalten wir eine Basis, die wir für alle Zugriffe auf Objekte dieser Klasse nutzen können, was die Wiederverwendbarkeit dieser Klasse erhöht. Der zweite Teil der Validierung ist das Hinzufügen einer bestimmten Eigenschaft zum Binding des Steuerelements, im Falle eines Textfeldes also beispielsweise zum Attribut Text. Außerdem müssen wir noch definieren, wie sich das Aussehen des Textfeldes ändern soll, wenn die Validierung fehlgeschlagen ist. Immerhin wollen wir den Benutzer ja auch informieren, wenn dieser eine Fehleingabe tätigt. Dies erledigen wir durch eine entsprechende Vorlage für das TextBox-Steuerelement. Schauen wir uns nun die drei Elemente der Validierung an.<\/p>\n Unser Entity Data Model, das wir auf Basis der SQL Server-Datenbank Bestellverwaltung erstellt haben, enthält auch eine Klasse namens Kunde.cs, welche die Eigenschaften eines Kunden abbildet. Diese erweitern wir nun um die Schnittstelle IDataErrorInfo. Da diese in der Bibliothek System.ComponentModel beschrieben wird, fügen wir zunächst einen Verweis auf diese Schnittstelle per using-Schlüsselwort hinzu:<\/p>\n Danach legen wir in der Kopfzeile der Klasse fest, dass diese die Schnittstelle IDataErrorInfo implementieren soll. Die Zeile sieht dann so aus:<\/p>\n Um die Member dieser Schnittstelle schnell zu implementieren, wählen Sie den Kontextmenü-Eintrag Schnellaktionen und Refactorings von IDataErrorInfo aus. Im nun erscheinenden Popup wählen Sie Schnittstelle implementieren aus und erstellen so die beiden Methoden dieser Schnittstelle. Diese sehen zunächst wie folgt aus:<\/p>\n Hier fügen wir nun für die Methode this eine erste Validierung ein. Diese soll sicherstellen, dass die Eingabe in das Feld Vorname nicht offen bleibt.<\/p>\n Die Methode this nimmt mit dem Parameter columnName immer den Namen des Feldes entgegen, das untersucht werden soll – in diesem Fall Vorname. Im get-Teil der Methode deklarieren wir die Variable result als string und prüfen in einer if-Bedingung, ob columnName den Wert Vorname enthält. Falls ja, prüfen wir, ob Vorname den Wert null enthält oder leer ist (IsNullOrEmpty). Ist das der Fall, stellen wir den Rückgabewert mit der Variablen errorMessage auf den Text Bitte geben Sie einen Vornamen ein. ein (siehe Listing 1).<\/p>\n Listing 1: Implementierung der Schnittstelle IDataErrorInfo in der Klasse Kunde.cs<\/span><\/b><\/p>\n Wenn Sie das Projekt nun starten, einen neuen Kunden anlegen und einen Vornamen mit maximal drei Zeichen angeben, tut sich jedoch erst einmal nichts. Das ist auch kein Wunder, denn wir haben ja im .xaml-Code auch noch nicht angegeben, dass es eine Validierung gibt.<\/p>\n Damit die Methode this der Klasse Kunde.cs überhaupt aufgerufen wird, müssen wir der Bindung des Textfeldes Vorname das Attribut ValidatesOnDataErrors hinzufügen und dafür den Wert true festlegen:<\/p>\n Ein erneuter Start der Anwendung und die Eingabe eines ungültigen Ausdrucks zeigt nun Wirkung: Das fehlerhafte Feld wird mit einem roten Rahmen versehen (siehe Bild 2).<\/p>\n Bild 2: Eine fehlerhafte Eingabe wird durch einen roten Rahmen markiert.<\/span><\/b><\/p>\n Nun fehlt noch der Hinweis für den Benutzer, damit er weiß, was er bei der Eingabe falsch gemacht hat. Dazu wollen wir rechts vom Textfeld ein Warnsymbol anzeigen, das beim Überfahren mit der Maus einen ToolTip-Text einblendet. Dazu ist nicht mehr nötig als die Änderung einiger Eigenschaften des TextBox-Elements. Da wir diese nicht nur für eine TextBox benötigen, sondern für alle, definieren wir direkt ein entsprechendes Style-Element in den Ressourcen des übergeordneten Elements, hier also für ein Page-Element.<\/p>\n Möchten Sie weiterlesen? Dann lösen Sie Ihr Ticket!<\/span>Validierung<\/h2>\n
Validierung auf Feldebene<\/h2>\n
\n
Einfache Validierung<\/h2>\n
Beispielanwendung<\/h2>\n
Ablauf der Validierung<\/h2>\n
Aufbau der Validierung<\/h2>\n
Anpassen der Klasse Kunde.cs<\/h2>\n
using System.ComponentModel;<\/pre>\n
public partial class Kunde : IDataErrorInfo {\r\n...<\/pre>\npublic string Error {\r\n get {\r\n throw new NotImplementedException();\r\n }\r\n}\r\npublic string this[string columnName] {\r\n get {\r\n throw new NotImplementedException();\r\n }\r\n}<\/pre>\npublic string this[string columnName] {\r\n get {\r\n string errorMessage = \"\";\r\n switch (columnName) {\r\n case \"Vorname\":\r\n {\r\n if (String.IsNullOrEmpty(Vorname)) {\r\n errorMessage = \"Bitte geben Sie einen Vornamen ein.\";\r\n }\r\n break;\r\n }\r\n }\r\n return errorMessage;\r\n }\r\n}<\/pre>\n.xaml-Code erweitern<\/h2>\n
<TextBox x:Name=\"txtVorname\" Grid.Column=\"1\" Grid.Row=\"3\" HorizontalAlignment=\"Stretch\" Text=\"{Binding kunde.Vorname, Mode=TwoWay, ValidatesOnDataErrors=True}\" \/><\/pre>\n![\"Eine](\"..\/fileadmin\/_temp_\/2016_06\/pic_67_006.png\")
<\/p>\nValidierungshinweis anbringen<\/h2>\n
\nHier geht es zur Bestellung des Jahresabonnements des Magazins Visual Basic Entwickler<\/strong>:<\/span>
\nZur Bestellung ...<\/a><\/span>
\nDanach greifen Sie sofort auf alle rund 200 Artikel<\/strong> unseres Angebots zu - auch auf diesen hier!<\/span>
\nOder haben Sie bereits Zugangsdaten? Dann loggen Sie sich gleich hier ein:<\/span><\/p>\n<\/div>\n\n\t\n\t