Datenvalidierung

Datenvalidierungstypen und -ausführung

Microsoft Excel unterstützt eine Reihe verschiedener Arten der Datenvalidierung. Jeder Typ wird verwendet, um zu steuern, welcher Datentyp in eine Zelle oder einen Zellbereich eingegeben wird. Unten veranschaulichen Code-Snippets, wie dies validiert werden kann:

Datenvalidierung mit Microsoft Excel

So erstellen Sie Validierungen mit Microsoft Excel:

  1. Wählen Sie in einem Arbeitsblatt die Zellen aus, auf die Sie die Validierung anwenden möchten.

  2. Von demDatenMenü, auswählenValidierung. Der Validierungsdialog wird angezeigt.

  3. Drücke denEinstellungenRegisterkarte und geben Sie die Einstellungen wie unten gezeigt ein.

    Datenvalidierungseinstellungen

todo: Bild_alt_Text

Datenvalidierung mit Aspose.Cells

Die Datenvalidierung ist eine leistungsstarke Funktion zur Validierung der in Arbeitsblätter eingegebenen Informationen. Mit der Datenvalidierung können Entwickler Benutzern eine Auswahlliste zur Verfügung stellen, Dateneingaben auf einen bestimmten Typ oder eine bestimmte Größe beschränken usw. In Aspose.Cells, jederArbeitsblattKlasse hat einValidierungenObjekt, das eine Sammlung von darstelltValidierungObjekte. Um die Validierung einzurichten, legen Sie einige derValidierungKlasseneigenschaften:

  • Typ: stellt den Validierungstyp dar, der durch Verwendung eines der vordefinierten Werte in angegeben werden kannValidierungstypAufzählung.
  • Operator: stellt den bei der Validierung zu verwendenden Operator dar, der durch Verwendung eines der vordefinierten Werte in angegeben werden kannBetreibertypAufzählung.
  • Formel 1: stellt den Wert oder Ausdruck dar, der dem ersten Teil der Datenvalidierung zugeordnet ist.
  • Formel2: stellt den Wert oder Ausdruck dar, der dem zweiten Teil der Datenvalidierung zugeordnet ist.

Wenn dieValidierungObjekteigenschaften konfiguriert wurden, können Entwickler die verwendenZellbereich-Struktur zum Speichern von Informationen über den Zellbereich, der mithilfe der erstellten Validierung validiert wird.

Arten der Datenvalidierung

Die Datenvalidierung ermöglicht es Ihnen, Geschäftsregeln in jede Zelle einzubauen, sodass falsche Eingaben zu Fehlermeldungen führen. Geschäftsregeln sind die Richtlinien und Verfahren, die die Funktionsweise eines Unternehmens regeln. Aspose.Cells unterstützt alle wichtigen Arten der Datenvalidierung.

DasValidierungstypAufzählung hat folgende Mitglieder:

Mitgliedsname Beschreibung
ANY_VALUE Bezeichnet einen Wert eines beliebigen Typs.
GANZE ZAHL Bezeichnet den Validierungstyp für ganze Zahlen.
DEZIMAL Bezeichnet den Validierungstyp für Dezimalzahlen.
AUFFÜHREN Gibt den Validierungstyp für die Dropdown-Liste an.
DATUM Bezeichnet den Validierungstyp für Datumsangaben.
ZEIT Bezeichnet den Validierungstyp für Zeit.
TEXT_LÄNGE Bezeichnet den Validierungstyp für die Länge des Textes.
BRAUCH Bezeichnet den benutzerdefinierten Validierungstyp.

Programmierbeispiel: Ganzzahlige Datenvalidierung

Bei dieser Art der Validierung können Benutzer nur ganze Zahlen innerhalb eines bestimmten Bereichs in die validierten Zellen eingeben. Die folgenden Codebeispiele zeigen, wie die implementiert wirdGANZE ZAHLValidierungstyp. Das Beispiel erstellt dieselbe Datenvalidierung mit Aspose.Cells, die wir oben mit Microsoft Excel erstellt haben.

Programmierbeispiel: Dezimaldatenvalidierung

Bei dieser Art der Validierung kann der Benutzer Dezimalzahlen in die validierten Zellen eingeben. Im Beispiel ist der Benutzer darauf beschränkt, nur Dezimalwerte einzugeben, und der Validierungsbereich ist A1:A10.

Programmierbeispiel: Validierung von Listendaten

Diese Art der Validierung ermöglicht es dem Benutzer, Werte aus einer Dropdown-Liste einzugeben. Es stellt eine Liste bereit: eine Reihe von Zeilen, die Daten enthalten. Benutzer können nur Werte aus der Liste auswählen. Der Validierungsbereich ist der Zellbereich A1:A5 im ersten Arbeitsblatt.

Wichtig ist hier, dass Sie die einstellenValidierung.setInCellDropDown Eigentum zuwahr.

Programmierbeispiel: Datumsdatenvalidierung

Bei dieser Art der Validierung geben Benutzer Datumswerte innerhalb eines bestimmten Bereichs oder nach bestimmten Kriterien in die validierten Zellen ein. Im Beispiel ist der Benutzer auf die Eingabe von Daten zwischen 1970 und 1999 beschränkt. Hier ist der Validierungsbereich die Zelle B1.

Programmierbeispiele: Zeitdatenvalidierung

Bei dieser Art der Validierung können Benutzer Zeiten innerhalb eines bestimmten Bereichs oder bestimmte Kriterien erfüllende Zeiten in die validierten Zellen eingeben. Im Beispiel ist der Benutzer auf die Eingabe von Zeiten zwischen 09:00 und 11:30 Uhr beschränkt. Hier ist der Validierungsbereich die B1-Zelle.

Programmierbeispiele: Validierung von Textlängendaten

Bei dieser Art der Validierung können Benutzer Textwerte einer bestimmten Länge in die validierten Zellen eingeben. Im Beispiel ist der Benutzer darauf beschränkt, Zeichenfolgenwerte mit nicht mehr als 5 Zeichen einzugeben. Der Validierungsbereich ist die B1-Zelle.

Datenvalidierungsregeln

Wenn Datenvalidierungen implementiert sind, kann die Validierung überprüft werden, indem den Zellen unterschiedliche Werte zugewiesen werden.Cell.GetValidationValue() kann verwendet werden, um das Validierungsergebnis abzurufen. Das folgende Beispiel demonstriert diese Funktion mit unterschiedlichen Werten. Die Beispieldatei kann zum Testen unter folgendem Link heruntergeladen werden:

SampleDataValidationRules.xlsx

Beispielcode

Überprüfen Sie, ob die Validierung in einer Zelle Dropdown ist

Wie wir gesehen haben, gibt es viele Arten von Validierungen, die innerhalb einer Zelle implementiert werden können. Wenn Sie überprüfen möchten, ob die Validierung ein Dropdown-Menü ist oder nicht,Validierung.InCellDropDown Eigenschaft kann verwendet werden, um dies zu testen. Der folgende Beispielcode demonstriert die Verwendung dieser Eigenschaft. Die Beispieldatei zum Testen kann unter folgendem Link heruntergeladen werden:

sampleDataValidationRules.xlsx

CellArea zu vorhandener Validierung hinzufügen

Es kann Fälle geben, in denen Sie hinzufügen möchtenZellbereichzu bestehenValidierung. Wenn Sie hinzufügenZellbereichverwendenValidierung.AddArea(CellArea cellArea), Aspose.Cells überprüft alle bestehenden Bereiche, ob der neue Bereich bereits existiert. Wenn die Datei eine große Anzahl von Validierungen hat, wird die Leistung beeinträchtigt. Um dies zu überwinden, bietet die API dieValidation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) Methode. DascheckKreuzungDer Parameter gibt an, ob die Überschneidung eines bestimmten Bereichs mit bestehenden Validierungsbereichen überprüft werden soll. Einstellen aufFALSCHdeaktiviert die Überprüfung anderer Bereiche. DascheckEdgeDer Parameter gibt an, ob die angewendeten Bereiche überprüft werden sollen. Wenn der neue Bereich zum Bereich oben links wird, werden die internen Einstellungen neu erstellt. Wenn Sie sicher sind, dass der neue Bereich nicht der obere linke Bereich ist, können Sie diesen Parameter auf setzenFALSCH.

Das folgende Code-Snippet demonstriert die Verwendung vonValidation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge)-Methode zum Hinzufügen neuerZellbereichzu bestehenValidierung.

Die Quell- und Ausgabe-Excel-Dateien sind als Referenz beigefügt.

Quelldatei

Ausgabedatei

Themen vorantreiben