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
Képlet | Ismertetés | Eredmény |
---|---|---|
Validate( Scores, Percentage, 10 ) | Ellenőrzi, hogy a 10 a Scores adatforrás Percentage oszlopában érvényes érték-e. | üres |
Validate( Scores, Percentage, 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.” |