Overiť funkciu

Vzťahuje sa na: aplikácie plátna aplikácie s podporou modelov

Funkcia Validate kontroluje, či je hodnota jedného stĺpca alebo celého záznamu platná pre zdroj údajov.

Popis

Skôr, ako používateľ odošle zmenu údajov, môžete poskytnúť okamžitú spätnú väzbu týkajúcu sa jej platnosti a zlepšiť tým prácu ostatných používateľov.

Zdroje údajov dokážu poskytnúť informácie o tom, aké sú platné hodnoty v rámci záznamov. Tieto informácie môžu obsahovať veľa obmedzení, napríklad:

• či stĺpec vyžaduje hodnotu,
• aký dlhý môže byť reťazec textu,
• aké vysoké a nízke môže byť číslo,
• aký skorý a neskorý môže byť dátum.

Funkcia Validate pomocou týchto informácií určuje, či je hodnota platná, a ak nie je, vráti príslušné chybové hlásenie. Pomocou funkcie DataSourceInfo môžete zobraziť tie informácie, ktoré funkcia Validate používa.

Zdroje údajov sa líšia v tom, koľko overovacích informácií poskytujú, vrátane možnosti, že neposkytujú vôbec žiadne. Funkcia Validate dokáže overiť hodnoty iba na základe týchto informácií. Dokonca aj keď funkcia Validate nenájde žiaden problém, nemusí byť zmena údajov úspešná. Informácie o zlyhaní môžete získať prostredníctvom funkcie Errors.

Ak funkcia Validate nájde problém, vráti chybové hlásenie, ktoré môžete zobraziť používateľovi aplikácie. Ak sú všetky hodnoty platné, funkcia Validate vráti blank. Pri práci s kolekciou, ktorá nemá žiadne overovacie informácie, sú hodnoty vždy platné.

Syntax

Validate( DataSource, Column, Value )

• DataSource – povinné. Zdroj údajov slúžiaci na overenie platnosti.
• Column – povinné. Stĺpec, ktorý sa má overiť.
• Hodnota – povinné. Hodnota vybratého stĺpca, ktorá sa má overiť.

Validate( DataSource, OriginalRecord, Updates )

• DataSource – povinné. Zdroj údajov slúžiaci na overenie platnosti.
• OriginalRecord – povinné. Záznam, ktorého aktualizácie sa majú overiť.
• Aktualizácie – povinné. Zmeny, ktoré sa majú aplikovať na pôvodný záznam.

Príklady

V týchto príkladoch musia byť hodnoty v stĺpci Percentage zdroja údajov Scores medzi 0 a 100 (vrátane). Ak údaje prejdú overením, funkcia vráti prázdnu hodnotu. V opačnom prípade vráti funkcia chybové hlásenie.

Overenie jedného stĺpca

Vzorec	Popis	Výsledok
Validate( Scores, Percentage, 10 )	Skontroluje, či je hodnota 10 platnou hodnotou pre stĺpec Percentage v zdroji údajov Scores.	blank
Validate( Scores, Percentage, 120 )	Skontroluje, či je hodnota 120 platnou hodnotou pre stĺpec Percentage v zdroji údajov Scores.	Hodnoty musia byť v rozsahu od 0 do 100.

Overenie úplného záznamu

Vzorec	Popis	Výsledok
Validate( Scores, EditRecord, Gallery.Updates )	Skontroluje, či sú hodnoty vo všetkých stĺpcoch platnými hodnotami pre zdroj údajov Scores. V tomto príklade hodnota v stĺpci Percentage je 10.	blank
Validate( Scores, EditRecord, Gallery.Updates )	Skontroluje, či sú hodnoty vo všetkých stĺpcoch platnými hodnotami pre zdroj údajov Scores. V tomto príklade hodnota v stĺpci Percentage je 120.	Hodnoty musia byť v rozsahu od 0 do 100.