Validate funktsioon

Kehtib järgmise kohta: Lõuendirakendused Mudelipõhised rakendused

Funktsioon Validate kontrollib, kas andmeallika puhul kehtib ühe veeru või täieliku kirjeväärtus.

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 tagastada asjakohane tõrketeade, kui mitte. Funktsiooni DataSourceInfo abil saate vaadata sama teavet, mida Validate kasutate.

Andmeallikad varieeruvad selles, kui palju kinnitamise teavet nad pakuvad või ei sisalda seda üldse. Validate saab väärtusi kontrollida ainult selle teabe põhjal. Isegi kui Validate probleem ei lahene, võib andmete muutmise rakendamine endiselt nurjuda. Funktsiooni Errors saate kasutada tõrke kohta teabe saamiseks.

Kui Validate leiab probleemi, tagastab funktsioon tõrketeate, mille saate rakenduse kasutajale kuvada. Kui kõik väärtused on sobivad, Validate tagastab väärtuse Tühi. 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.
• Uuendused - 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.

Validate ühe veeruga

Valem	Kirjeldus	Tulem
Validate( Tulemused, protsent, 10 )	Kontrollib, kas 10 on andmeallika Scores veeru Percentage kehtiv väärtus.	tühi
Validate( Tulemused, protsent, 120 )	Kontrollib, kas 120 on andmeallika Scores veeru Percentage kehtiv väärtus.	"Väärtused peavad jääma vahemikku 0 kuni 100."

Validate täieliku kirjega

Valem	Kirjeldus	Tulem
Validate( Tulemused, Redigeeri_kirjet, Galerii.Värskendused )	Kontrollib, kas andmeallika Scores veergude väärtused kehtivad. Selles näites on veeru Percentage väärtuseks 10.	tühi
Validate( Tulemused, Redigeeri_kirjet, Galerii.Värskendused )	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."