Funktionen Validate

Gælder for: Lærredapps Modelbaserede apps

Funktionen Validate kontrollerer, om værdien af en enkelt kolonne eller en komplet post er gyldig for en datakilde.

Beskrivelse

Før en bruger indsender en dataændring, kan du give øjeblikkelig feedback på gyldigheden af indsendelsen, hvilket giver en bedre brugeroplevelse.

Datakilder kan give oplysninger om, hvad der udgør gyldige værdier i en post. Disse oplysninger kan omfatte mange begrænsninger som f.eks. disse eksempler:

• om en kolonne kræver en værdi
• hvor lang en tekststreng kan være
• hvor højt og lavt et tal kan være
• hvor tidligt og sent en dato kan være

Funktionen Validate bruger disse oplysninger til at afgøre, om en værdi er gyldig og til at returnere en fejlmeddelelse hvis ikke. Du kan bruge funktionen DataSourceInfo til at få vist de samme oplysninger, som Validate bruger.

Datakilder kan variere mht., hvor mange valideringsoplysninger de giver, herunder slet ikke at give nogen. Validate kan kun bekræfte værdier baseret på disse oplysninger. Selv hvis Validate ikke finder et problem, kan anvendelse af dataændringen stadig mislykkes. Du kan bruge funktionen Errors til at få oplysninger om fejlen.

Hvis Validate finder et problem, returnerer funktionen en fejlmeddelelse, som du kan vise til brugeren af appen. Hvis alle værdier er gyldige, returnerer Validateblank. Når du arbejder med en samling, der ikke indeholder nogen valideringsoplysninger, er værdier altid gyldige.

Syntaks

Validate( DataSource, Column, Value )

• DataSource – påkrævet. Datakilden, der skal valideres med.
• Column – påkrævet. Kolonnen, der skal valideres.
• Value – påkrævet. Værdien for den markerede kolonne, der skal valideres.

Validate( DataSource, OriginalRecord, Updates )

• DataSource – påkrævet. Datakilden, der skal valideres med.
• OriginalRecord – påkrævet. Posten, som opdateringer skal valideres imod.
• Updates – påkrævet. Ændringerne, der anvendes for den oprindelige post.

Eksempler

For disse eksempler skal værdier i kolonnen Percentage i datakilden Scores være mellem 0 og 100. Hvis dataene består valideringen, returnerer funktionen tom. Ellers returnerer funktionen en fejlmeddelelse.

Valider med en enkelt kolonne

Valider med en komplet post