Validate függvény

A következőkre vonatkozik: Vászonalapú alkalmazások Modellalapú alkalmazások

A Validate függvény ellenőrzi, hogy egy oszlop vagy egy teljes rekord értéke érvényes-e egy adatforrásra.

Ismertetés

Azonnali visszajelzést adhat a felhasználók adatmódosításai előtt, így jobb felhasználói élményt biztosíthat.

Az adatforrások információval szolgálhatnak arról, hogy egy rekordon belül melyek az érvényes értékek. Ez az információ számos korlátozást tartalmazhat, például a következőket:

• szükséges-e, hogy egy oszlophoz érték legyen rendelve
• milyen hosszú lehet egy sztring
• milyen magas és alacsony lehet egy szám
• milyen korai és késői lehet egy dátum

A Validate függvény ezen információk alapján állapítja meg, hogy egy érték érvényes-e, és ha nem, megfelelő hibaüzenetet ad vissza. A DataSourceInfo függvény használatával ugyanazokat az információkat tekintheti meg, amelyeket Validate használ.

Az adatforrások által nyújtott ellenőrzési információ eltérő lehet. Ez jelentheti azt is, hogy semmilyen információval nem szolgálnak. Validate csak ezen információk alapján tudja ellenőrizni az értékeket. Még ha Validate nem is talál problémát, az adatváltozás alkalmazása továbbra is sikertelen lehet. Az Errors függvény segítségével információt szerezhet a hibáról.

Ha Validate probléma merül fel, a függvény egy hibaüzenetet ad vissza, amelyet megjeleníthet az alkalmazás felhasználójának. Ha minden érték érvényes, Validateüres értéket ad vissza. Ha olyan gyűjteménnyel dolgozik, amely nem tartalmaz ellenőrzési információkat, akkor az értékek mindig érvényesek.

Szintaxis

Validate( Adatforrás, oszlop, érték )

• DataSource – Kötelező. Az adatforrás, amellyel az érvényesítést végzi.
• Oszlop – Kötelező. Az ellenőrizni kívánt oszlop.
• Érték – Kötelező. A kiválasztott oszlopra vonatkozó, ellenőrizni kívánt érték.

Validate( DataSource, OriginalRecord, Updates )

• DataSource – Kötelező. Az adatforrás, amellyel az érvényesítést végzi.
• OriginalRecord - Kötelező. A rekord, amelynek a frissítéseit ellenőrizni kívánja.
• Frissítések - Kötelező. Az eredeti rekordon végzett módosítások.

Példák

E példák esetében a Scores adatforrás Percentage oszlopában lévő értékeknek 0 és 100 között kell lenniük, a határértékeket is beleértve. Ha az adat megfelel az ellenőrzés követelményeinek, a függvény üres értéket ad vissza. Ellenkező esetben a függvény hibaüzenetet ad vissza.

Validate egyetlen oszloppal

Képlet	Ismertetés	Eredmény
Validate( Pontszámok, százalék, 10 )	Ellenőrzi, hogy a 10 a Scores adatforrás Percentage oszlopában érvényes érték-e.	üres
Validate( Pontszámok, százalék, 120 )	Ellenőrzi, hogy a 120 a Scores adatforrás Percentage oszlopában érvényes érték-e.	„Az értékeknek 0 és 100 között kell lenniük.”

Validate teljes rekorddal

Képlet	Ismertetés	Eredmény
Validate( Scores, EditRecord, Gallery.Updates )	Ellenőrzi, hogy a Scores adatforráshoz tartozó minden oszlopban érvényesek-e az értékek. Ebben a példában a Percentage (Százalék) oszlopban lévő érték 10.	üres
Validate( Scores, EditRecord, Gallery.Updates )	Ellenőrzi, hogy a Scores adatforráshoz tartozó minden oszlopban érvényesek-e az értékek. Ebben a példában a Percentage (Százalék) oszlopban lévő érték 120.	„Az értékeknek 0 és 100 között kell lenniük.”