Funktion „Validate“ in PowerAppsValidate function in PowerApps

Die Validate-Funktion überprüft, ob der Wert einer einzelnen Spalte oder eines vollständigen Datensatzes für eine Datenquelle gilt.The Validate function checks whether the value of a single column or a complete record is valid for a data source.

BeschreibungDescription

Bevor ein Benutzer eine Änderung von Daten übermittelt, können Sie unmittelbar Feedback zur Gültigkeit dieser Übermittlung geben, was zu einer besseren Benutzerfreundlichkeit führt.Before a user submits a data change, you can provide immediate feedback on the validity of that submission, resulting in a better user experience.

Datenquellen können Informationen dazu bereitstellen, was gültige Werte in einem Datensatz auszeichnen.Data sources can provide information on what constitutes valid values within a record. Diese Informationen können viele Einschränkungen enthalten, z.B.:This information can include many constraints, such as these examples:

  • ob eine Spalte einen Wert erfordertwhether a column requires a value
  • wie lang eine Textzeichenfolge sein kannhow long a string of text can be
  • wie groß oder klein eine Zahl sein kannhow high and low a number can be
  • wie früh oder spät ein Datum sein kannhow early and late a date can be

Die Validate-Funktion verwendet diese Informationen, um zu bestimmen, ob ein Wert gültig ist, und um eine entsprechende Fehlermeldung zurückzugeben, falls dies nicht der Fall ist.The Validate function uses this information to determine whether a value is valid and to return an appropriate error message if not. Sie können die DataSourceInfo-Funktion verwenden, um die gleichen Informationen anzuzeigen, die Validate verwendet.You can use the DataSourceInfo function to view the same information that Validate uses.

Datenquellen stellen unterschiedlich viele Gültigkeitsinformationen zur Verfügung, manchmal sogar gar keine.Data sources vary in how much validation information they provide, including not providing any at all. Validate kann Werte nur basierend auf diesen Informationen überprüfen.Validate can only verify values based on this information. Auch wenn Validate kein Problem findet, kann bei der Anwendung der Datenänderung dennoch ein Fehler auftreten.Even if Validate doesn't find a problem, applying the data change may still fail. Sie können die Errors-Funktion verwenden, um Informationen über den Fehler abzurufen.You can use the Errors function to obtain information about the failure.

Wenn Validate ein Problem findet, gibt die Funktion eine Fehlermeldung zurück, die Sie dem Benutzer der App anzeigen können.If Validate finds a problem, the function returns an error message that you can show to the user of the app. Wenn alle Werte gültig sind, gibt Validate blank zurück.If all values are valid, Validate returns blank. Beim Arbeiten mit einer Sammlung, die über keine Gültigkeitsinformationen verfügt, sind Werte immer gültig.When you work with a collection that has no validation information, values are always valid.

SyntaxSyntax

Validate( Datenquelle, Spalte, Wert )Validate( DataSource, Column, Value )

  • Datenquelle: Erforderlich.DataSource – Required. Die Datenquelle, mit der überprüft werden soll.The data source to validate with.
  • Spalte: Erforderlich.Column – Required. Die Spalte, die überprüft werden soll.The column to validate.
  • Wert: Erforderlich.Value – Required. Der Wert für die ausgewählte Spalte, die überprüft werden soll.The value for the selected column to be validated.

Validate( Datenquelle, UrsprünglicherDatensatz, Updates )Validate( DataSource, OriginalRecord, Updates )

  • Datenquelle: Erforderlich.DataSource – Required. Die Datenquelle, mit der überprüft werden soll.The data source to validate with.
  • UrsprünglicherDatensatz: Erforderlich.OriginalRecord - Required. Der Datensatz, für den Updates überprüft werden sollen.The record to which updates are to be validated.
  • Updates: Erforderlich.Updates - Required. Die Änderungen, die am ursprünglichen Datensatz vorgenommen werden sollen.The changes to apply to the original record.

BeispieleExamples

Für diese Beispiele müssen die Werte in der Spalte Percentage (Prozentzahl) der Datenquelle Scores (Ergebnisse) zwischen 0 und (einschließlich) 100 liegen.For these examples, values in the Percentage column of the Scores data source must be between 0 and 100, inclusive. Wenn die Daten die Überprüfung bestehen, gibt die Funktion blank zurück.If the data passes validation, the function returns blank. Andernfalls gibt die Funktion eine Fehlermeldung zurück.Otherwise, the function returns an error message.

Überprüfen mit einer einzelnen SpalteValidate with a single column

FormelFormula BeschreibungDescription ErgebnisResult
Validate( Scores, Percentage, 10 )Validate( Scores, Percentage, 10 ) Überprüft, ob 10 ein gültiger Wert für die Spalte Percentage in der Datenquelle Scores ist.Checks whether 10 is a valid value for the Percentage column in the Scores data source. blankblank
Validate( Scores, Percentage, 120 )Validate( Scores, Percentage, 120 ) Überprüft, ob 120 ein gültiger Wert für die Spalte Percentage in der Datenquelle Scores ist.Checks whether 120 is a valid value for the Percentage column in the Scores data source. "Values must be between 0 and 100." (Werte müssen zwischen 0 und 100 liegen.)"Values must be between 0 and 100."

Überprüfen mit einem vollständigen DatensatzValidate with a complete record

FormelFormula BeschreibungDescription ErgebnisResult
Validate( Scores, EditRecord, Gallery.Updates )Validate( Scores, EditRecord, Gallery.Updates ) Überprüft, ob 10 ein gültiger Wert für die Spalte Percentage in der Datenquelle Scores ist.Checks whether 10 is a valid value for the Percentage column in the Scores data source. blankblank
Validate( Scores, EditRecord, Gallery.Updates )Validate( Scores, EditRecord, Gallery.Updates ) Überprüft, ob 120 ein gültiger Wert für die Spalte Percentage in der Datenquelle Scores ist.Checks whether 120 is a valid value for the Percentage column in the Scores data source. "Values must be between 0 and 100." (Werte müssen zwischen 0 und 100 liegen.)"Values must be between 0 and 100."