Validate funkcija

Taikoma: Drobės programėlės Modeliu pagrįstos programėlės

Funkcija Validate tikrina, ar vieno stulpelio ar viso įrašo reikšmė galioja duomenų šaltiniui.

Aprašas

Prieš vartotojui pateikiant duomenų pakeitimą, galite nedelsdami pateikti atsiliepimą dėl to pateikimo galiojimo, todėl pagerėja vartotojo patirtis.

Duomenų šaltiniai gali pateikti informaciją apie tai, kas sudaro leistinas įrašo vertes. Šioje informacijoje gali būti daug apribojimų, pvz., šie pavyzdžiai:

• ar stulpelyje būtina nurodyti vertę
• kokio ilgio gali būti teksto eilutė
• koks gali būti skaičius, didelis ar mažas
• kokio anksti ar vėlyva data gali būti

Funkcija Validate naudoja šią informaciją, kad nustatytų, ar reikšmė leistina, ir, jei ne, pateiktų atitinkamą klaidos pranešimą. Galite naudoti funkciją DataSourceInfo , kad peržiūrėtumėte tą pačią informaciją, kurią Validate naudojate.

Duomenų šaltiniai skiriasi pagal tai, kiek juose yra pateiktos tikrinimo informacijos, įskaitant nepateiktą. Validate gali tik patikrinti reikšmes pagal šią informaciją. Net jei Validate nepavyksta rasti problemos, duomenų keitimo taikymas vis tiek gali nepavykti. Galite naudoti Errorsfunkciją, kad gautumėte informaciją apie triktį.

Jei Validate randa problemą, funkcija pateikia klaidos pranešimą, kurį galite rodyti programos vartotojui. Jei visos reikšmės tinkamos, Validate pateikia tuščias reikšmes. Kai dirbate su rinkiniu, kuriame nėra tikrinimo informacijos, vertės visada galioja.

Sintaksė

Validate( DataSource, Column, Value )

• DataSource - būtina. Duomenų šaltinis, kurį norite patikrinti.
• Stulpelis – būtina. Stulpelis, kurį norite patikrinti.
• reikšmė – būtina. Pažymėto stulpelio vertė, kurią norite patikrinti.

Validate( DataSource, OriginalRecord, Updates )

• DataSource - būtina. Duomenų šaltinis, kurį norite patikrinti.
• OriginalRecord - Būtina. Įrašas, pagal kurį norite patikrinti naujinimus.
• Atnaujinimai - būtini. Pakeitimai, kuriuos norite taikyti originaliam įrašui.

Pavyzdžiai

Šiuose pavyzdžiuose vertės Scores duomenų šaltinio Percentage stulpelyje turi būti nuo 0 iki 100 imtinai. Jei duomenys yra patvirtinti, funkcija grąžina blank. Priešingu atveju funkcija grąžina klaidos pranešimą.

Validate su vienu stulpeliu

Formulė	Aprašas	Rezultatas
Validate( Įvertinimai, Procentas, 10 )	Tikrina, ar 10 yra leistina vertė Percentage stulpeliui Scores duomenų šaltinyje.	Tuščią
Validate( Taškai, Procentas, 120 )	Tikrina, ar 120 yra leistina vertė Percentage stulpeliui Scores duomenų šaltinyje.	„Vertės turi būti nuo 0 iki 100.”

Validate su išsamiu įrašu

Formulė	Aprašas	Rezultatas
Validate( Rezultatai, Redaguotiįrašą, Gallery.Updates )	Tikrina, ar visų stulpelių vertės galioja Scoresduomenų šaltinyje. Šiame pavyzdyje vertė Percentage stulpelyje yra 10.	Tuščią
Validate( Rezultatai, Redaguotiįrašą, Gallery.Updates )	Tikrina, ar visų stulpelių vertės galioja Scoresduomenų šaltinyje. Šiame pavyzdyje vertė Percentage stulpelyje yra 120.	„Vertės turi būti nuo 0 iki 100.”