Validate Funkce

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

Funkce Validate zkontroluje, jestli je hodnota jednoho sloupce nebo kompletní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

Tato Validate funkce pomocí těchto informací určí, jestli je hodnota platná, a pokud ne, vrátí příslušnou chybovou zprávu. Pomocí funkce DataSourceInfo můžete zobrazit stejné informace, které Validate používají.

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ěřovat pouze hodnoty na základě těchto informací. I když Validate problém nenajdete, může použití změny dat selhat. Ke získání informací o chybě můžete použít funkci Errors.

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

Syntaxe

Validate( Zdroj dat, sloupec, hodnota )

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

Validate( DataSource, OriginalRecord, Updates )

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

Validate s jedním sloupcem

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

Validate s úplným záznamem

Vzorec	Popis	Výsledek
Validate( Scores, EditRecord, Gallery.Updates )	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ý
Validate( Scores, EditRecord, Gallery.Updates )	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.