Függvény érvényesítése

A következőkre vonatkozik: Vászonalapú alkalmazások Modellvezérelt alkalmazások

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

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 ezt az információt használja annak meghatározásához, hogy egy érték érvényes-e, és ha nem az, akkor egy megfelelő hibaüzenetet ad vissza. A DataSourceInfo függvény segítségével is megtekintheti a Validate függvény által használt információkat.

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. A Validate függvénnyel csak az ezen információn alapuló értékek ellenőrizhetők. Ha a Validate függvény nem talál problémát, akkor is előfordulhat, hogy az adatmódosítás alkalmazása sikertelen. Az Errors függvény segítségével információt szerezhet a hibáról.

Ha a Validate függvény problémát talál, hibaüzenetet ad vissza, amelyet megmutathat az alkalmazás felhasználójának. Ha minden érték érvényes, a Validate függvény blank mezőt 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( DataSource, Column, Value )

• DataSource (Adatforrás) – kötelező. Az adatforrás, amellyel az érvényesítést végzi.
• Column – 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 (Adatforrás) – 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.
• Updates – 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.

Ellenőrzés egy oszloppal

Ellenőrzés egy teljes rekorddal