Делите путем


Провера ваљаности функције

Важи за: Цанвас апликације Модел-дривен апликације

Функција Validate проверава да ли је вредност једне колоне или комплетног записа важећа за извор података.

Опис

Пре него што корисник пошаље промену података, можете одмах давати повратне информације о ваљаности тог подношења, што резултира бољим корисничким искуством.

Извори података могу пружити информације о томе шта чини важеће вредности у оквиру записа. Ове информације могу укључивати многа ограничења, као што су ови примери:

  • да ли колона захтева вредност
  • колико може да буде дуга ниска текста
  • колико број може да буде велики и мали
  • колико рано и касно може да буде датум

Функција Validate користи ове информације да би утврдила да ли је вредност важећа и да би вратила одговарајућу поруку о грешци, ако није. Можете користити функцију DataSourceInfo за приказ истих информација које користи Validate.

Извори података разликују се у томе колико потврђених информација обезбеђују, укључујући то да не обезбеђују никакве информације. Validate може да потврди вредности само на основу ових информација. Чак и ако Validate не пронађе проблем, примена промене података можда и даље није успела. Можете користити функциу Errors за прибављање информација о квару.

Ако Validate нађе проблем, функција враћа поруку о грешци коју можете показати кориснику апликације. Ако су све вредности ваљане, Validate враћа blank. Када радите са колекцијом која нема информације о валидацији, вредности су увек ваљане.

Синтакса

Validate( DataSource, Column, Value )

  • DataSource – Обавезно. Извор података са којим се проверава ваљаност.
  • Column – Обавезно. Колона за потврду.
  • Value – Обавезно. Вредност одабране колоне коју треба проверити.

Validate( DataSource, OriginalRecord, Updates )

  • DataSource – Обавезно. Извор података са којим се проверава ваљаност.
  • OriginalRecord – Обавезно. Запис за који треба проверити ваљаност исправки.
  • Updates – Обавезно. Промене ће се применити на изворни запис.

Примери

За ове примере, вредности у колони Проценат у извору података Резултати извор података мора бити између 0 и 100, укључиво. Ако подаци прођу проверу ваљаности, функција враћа празно. У супротном, функција враћа поруку о грешци.

Проверите ваљаност једном колоном

Формула Опис Резултат
Validate( Scores, Percentage, 10 ) Проверава да ли је 10 ваљана вредност за колону Проценат у извору података Резултати. празно
Validate( Scores, Percentage, 120 ) Проверава да ли је 120 ваљана вредност за колону Проценат у извору података Резултати. "Вредности морају бити између 0 и 100."

Провера ваљаности са потпуним записом

Формула Опис Резултат
Validate( Scores, EditRecord, Gallery.Updates ) Проверава да ли су вредности у свим колонама ваљане за извор података Резултати. У овом примеру вредност у колони Проценат је 10. празно
Validate( Scores, EditRecord, Gallery.Updates ) Проверава да ли су вредности у свим колонама ваљане за извор података Резултати. У овом примеру вредност у колони Проценат је 120. "Вредности морају бити између 0 и 100."