Valideeri funktsioon
Kehtib:
lõuendirakendused Mudelipõhised rakendused
Funktsioon Validate kontrollib, kas ühe veeru või täieliku kirje väärtus on andmeallika jaoks kehtiv.
Kirjeldus
Enne, kui kasutaja esitab andmete muutmise, saate anda kohest tagasisidet selle esitamise kehtivuse kohta, mille tulemuseks on parem kasutajakogemus.
Andmeallikad võivad anda teavet selle kohta, mis on kirjes kehtivad väärtused. See teave võib sisaldada mitmeid piiranguid, näiteks järgmisi.
- Kas veerg nõuab väärtust
- Kui pikk võib tekstistringi olla
- Kui suur ja väike võib arv olla
- Kui varajane ja hiline võib kuupäeva olla
Funktsioon Validate kasutab seda teavet, et teha kindlaks, kas väärtus on kehtiv, ja et tagastada sobiva tõrketeate, kui väärtus ei ole kehtiv. Funktsiooniga DataSourceInfo saate vaadata sama teavet, mida funktsioon Validate kasutab.
Andmeallikad varieeruvad selles, kui palju kinnitamise teavet nad pakuvad või ei sisalda seda üldse. Funktsioon Valideeri saab kontrollida ainult selle teabe põhjal antud väärtusi. Isegi juhul, kui funktsioon Valideeri probleemi ei leia, võib andmete muutmise rakendamine siiski nurjuda. Funktsiooni Errors saate kasutada tõrke kohta teabe saamiseks.
Kui funktsioon Validate leiab probleemi, tagastab funktsioon tõrketeate, mida saate rakenduse kasutajale kuvada. Kui kõik väärtused on kehtivad, tagastab funktsioon Validate väärtuse blank. Kui töötate kogumiga, millel pole kinnitamise teavet, on väärtused alati kehtivad.
Süntaks
Validate( DataSource, Column, Value )
- DataSource – Nõutav. Andmeallikas kinnitamiseks.
- Veerg – Nõutav. Veerg kinnitamiseks.
- Väärtus – Nõutav. Valitud veeru väärtus kinnitamiseks.
Validate( DataSource, OriginalRecord, Updates )
- DataSource – Nõutav. Andmeallikas kinnitamiseks.
- OriginalRecord - Nõutav. Kirje, millesse värskendused tuleb kinnitada.
- Värskendused - Nõutav. Algsele kirjele rakendatavad muudatused.
Näited
Nende näidete korral peavad väärtused andmeallika Scores veerus Percentage olema vahemikus 0–100 (kaasa arvatud). Kui andmed on kinnitatud, tagastab funktsioon väärtuse blank. Vastasel juhul tagastab funktsioon tõrketeate.
Kinnita ühe veeruga
| Valem | Kirjeldus | Tulem |
|---|---|---|
| Validate( Scores, Percentage, 10 ) | Kontrollib, kas 10 on andmeallika Scores veeru Percentage kehtiv väärtus. | tühi |
| Validate( Scores, Percentage, 120 ) | Kontrollib, kas 120 on andmeallika Scores veeru Percentage kehtiv väärtus. | "Väärtused peavad jääma vahemikku 0 kuni 100." |
Kinnita koos täieliku kirjega
| Valem | Kirjeldus | Tulem |
|---|---|---|
| Validate( Scores, EditRecord, Gallery.Updates ) | Kontrollib, kas andmeallika Scores veergude väärtused kehtivad. Selles näites on veeru Percentage väärtuseks 10. | tühi |
| Validate( Scores, EditRecord, Gallery.Updates ) | Kontrollib, kas andmeallika Scores veergude väärtused kehtivad. Selles näites on veeru Percentage väärtuseks 120. | "Väärtused peavad jääma vahemikku 0 kuni 100." |