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. Az érvényesítés csak ezen információk alapján tudja ellenőrizni az értékeket. 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

Érvényesítés( 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.

Érvényesítés( 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.

Ellenőrzés egy 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.”

Ellenőrzés egy 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.”