Funkce Validate

Platí pro: aplikace plátna modelem řízené aplikace

Funkce Validate kontroluje, jestli je hodnota jednoho sloupce nebo celého záznamu platná pro zdroj dat.

Popis

Předtím, než uživatel odešle změnu dat, můžete poskytnout okamžitou zpětnou vazbu ohledně její platnosti, aby se uživatelům příjemněji pracovalo.

Zdroje dat dokážou poskytovat informace o tom, jaké jsou platné hodnoty v rámci záznamu. Mezi tyto informace patří spousta omezení, například:

• Jestli sloupec vyžaduje hodnotu
• Jak dlouhý může být textový řetězec
• Jak vysoké a nízké může být číslo
• Jak brzké nebo pozdní může být datum

Funkce Validate pomocí těchto informací určuje, jestli je nějaká hodnota platná, a pokud není, vrátí příslušnou chybovou zprávu. Pomocí funkce DataSourceInfo můžete zobrazit informace, které funkce Validate používá.

Zdroje dat se liší v tom, kolik ověřovacích informací poskytují, včetně možnosti, kdy neposkytují vůbec žádné. Validate může ověřit hodnoty pouze na základě těchto informací. I když funkce Validate nenajde žádný problém, nemusí být změna dat úspěšná. Ke získání informací o chybě můžete použít funkci Errors.

Když funkce Validate najde nějaký problém, vrátí chybovou zprávu, kterou můžete zobrazit uživateli aplikace. Pokud jsou všechny hodnoty platné, vrátí funkce Validate hodnotu blank. Při práci s kolekcí, která nemá žádné ověřovací informace, jsou hodnoty vždycky platné.

Syntaxe

Ověřit( Zdroj dat, Sloupec, Hodnota )

• DataSource – Povinné. Zdroj dat, vůči kterému se má provést ověření.
• Sloupec – Povinný. Sloupec, který se má ověřit.
• Hodnota – Povinné. Hodnota vybraného sloupce, která se má ověřit.

Ověřit( Zdroj dat, OriginalRecord, Aktualizace )

• DataSource – Povinné. Zdroj dat, vůči kterému se má provést ověření.
• OriginalRecord – Povinný. Záznam, jehož aktualizace se mají ověřit.
• Aktualizace – Povinné. Změny, které se mají uplatnit na původní záznam.

Příklady

V těchto příkladech musí být hodnoty ve sloupci Percentage zdroje dat Scores mezi 0 a 100 (včetně). Pokud data projdou ověřením, vrátí funkce prázdnou hodnotu. V opačném případě vrátí funkce chybovou zprávu.

Ověření jednoho sloupce

Vzorec	Popis	Výsledek
Ověřit (skóre, procento, 10)	Zkontroluje, jestli je 10 platná hodnota sloupce Percentage ve zdroji dat Scores.	prázdný
Ověřit (skóre, procento, 120)	Zkontroluje, jestli je 120 platná hodnota sloupce Percentage ve zdroji dat Scores.	Hodnoty musí být mezi 0 a 100.

Ověření úplného záznamu

Vzorec	Popis	Výsledek
Ověřit (skóre, upravit záznam, galerie. aktualizace)	Zkontroluje, jestli jsou pro zdroj dat Scores platné hodnoty ve všech sloupcích. V tomto příkladu je ve sloupci Percentage hodnota 10.	prázdný
Ověřit (skóre, upravit záznam, galerie. aktualizace)	Zkontroluje, jestli jsou pro zdroj dat Scores platné hodnoty ve všech sloupcích. V tomto příkladu je ve sloupci Percentage hodnota 120.	Hodnoty musí být mezi 0 a 100.