funktionen Validate

Gælder for: Lærredsapps Modeldrevne 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 bestemme, om en værdi er gyldig, og til at returnere en passende 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. Validate Selvom der ikke findes et problem, kan det stadig mislykkes at anvende dataændringen. Du kan bruge funktionen Errors til at få oplysninger om fejlen.

Hvis Validate der opstår et problem, returnerer funktionen en fejlmeddelelse, som du kan vise til brugeren af appen. Hvis alle værdier er gyldige, Validate returneres blank. 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.
• Kolonne – Påkrævet. Kolonnen, der skal valideres.
• Værdi – 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.
• Opdateringer - 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.

Validate med en enkelt kolonne

Formel	Beskrivelse	Resultat
Validate( Scorer, Procent, 10 )	Kontrollerer, om 10 er en gyldig værdi for kolonnen Percentage i datakilden Scores.	hvid
Validate( Scorer, Procent, 120 )	Kontrollerer, om 120 er en gyldig værdi for kolonnen Percentage i datakilden Scores.	"Værdier skal være mellem 0 og 100."

Validate med en komplet post

Formel	Beskrivelse	Resultat
Validate( Scores, EditRecord, Gallery.Updates )	Kontrollerer, om værdierne i alle kolonner er gyldige for datakilden Scores. I dette eksempel er værdien i kolonnen Percentage10.	hvid
Validate( Scores, EditRecord, Gallery.Updates )	Kontrollerer, om værdierne i alle kolonner er gyldige for datakilden Scores. I dette eksempel er værdien i kolonnen Percentage120.	"Værdier skal være mellem 0 og 100."