Funkcia Validate

Vzťahuje sa na: Aplikácie plátna Modelom riadené aplikácie

Funkcia Validate skontroluje, č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 používa tieto informácie na určenie, či je hodnota platná, a ak nie je, vráti príslušné chybové hlásenie. Rovnaké informácie, ktoré Validate používa, môžete zobraziť pomocou funkcie DataSourceInfo.

Zdroje údajov sa líšia v tom, koľko overovacích informácií poskytujú, vrátane možnosti, že neposkytujú vôbec žiadne. Validate overovať hodnoty iba na základe týchto informácií. Dokonca aj keď Validate nenájdete problém, použitie zmeny údajov môže napriek tomu zlyhať. Informácie o zlyhaní môžete získať prostredníctvom funkcie Errors.

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

Syntax

Validate( ZdrojÚdajov, Stĺpec, Hodnota )

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

Validate( ZdrojÚdajov, OriginalRecord, Aktualizácie )

• 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.

Validate s jedným stĺpcom

Vzorec	Popis	Výsledok
Validate( Skóre, Percento, 10 )	Skontroluje, či je hodnota 10 platnou hodnotou pre stĺpec Percentage v zdroji údajov Scores.	prázdna
Validate( Skóre, Percento, 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.

Validate s úplným záznamom

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.	prázdna
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.