Программный продукт «QP8.Framework» (стр. 14 )

<IsFalse Source="{x:Definition is_smartphone}" />

<IsFalse Source="{x:Definition is_tablet}" />

</And>

Операнд «If»

Условный оператор. Выполняет действие, если условие принимает значение true. Допускается использование условных операторов If. Then и If. Else. Пример:

<If x:Key="condition_alias">

<IsNullOrEmpty />

         <If. False>

                 <If>

                         <Matches Expression="^[0-9|a-z|\-|_]+$"

  RegexOptions="IgnoreCase, CultureInvariant" />

  ...

                 </If>

</If. False>

</If>

Операнд «Not»

Операнд отрицания. Внутрь можно помещать только один элемент (любой операнд, ветвление или условие). Пример:

<Not>

<Or>

  <IsTrue Source="{x:Definition is_mobile}" />

  <IsTrue Source="{x:Definition is_smartphone}" />

</Or>

</Not>

Операнд «Or»

Логическое «ИЛИ». Внутрь можно помещать любые операнды, ветвления или условия в любом количестве. Пример см. выше.

Операнд «RequiredIf»

Сокращённый синтаксис для единичной проверки. Если условие внутри RequiredIf выполняется, то устанавливается сообщение об ошибке. Пример:

<ForMember Definition="{x:Definition AlternativeName}">

  <RequiredIf Message="Поле AlternativeName Должно быть заполнено, если не заполнено Name">

  <IsNullOrEmpty Source="{x:Definition Name}"/>

  </RequiredIf>

</ForMember>

Операнд «Sequence»

Последовательное выполнение условий. Пример:

<Sequence StopOnFirstFailure="True">

  <!--поддержка последовательных условий c различными сообщениями-->

  <If>

  <IsNull />

  <If. True>

  <WithMessage Text="Не может быть null" />

  </If. True>

  </If>

  <If>

  <IsNullOrEmpty />

  <If. True>

  <WithMessage Text="Не может быть пустой" />

  </If. True>

  </If>

  <If>

  <Not>

  <Length MinLength="5"/>

  </Not>

  <If. True>

  <WithMessage Text="Длина поля должна быть не менее 5 символов." />

  </If. True>

  </If>

</Sequence>

Условия

Условие проверки содержит поле Source, в котором должен быть указан псевдоним (alias) поля, значение которого необходимо проверить.

Для части условий существуют дополнительные параметры.

Если выполняются все следующие правила:

условие находится внутри правила ForMember, для условия не определено поле Source,

то для условия в качестве значения поля Source используется значение из правила.

Условие «AreEqual»

Проверка 2 свойств модели на равенство. Пример:

<AreEqual Source="{x:Definition password}" Target="{ x:Definition password_copy}" />

Условие «Equals»

Проверка равенства параметра заданному значению. Пример:

<Equals Source="{x:Definition physical_screen_width}" Value="400" />

Условие «GreaterThan»

Сравнение значения со значением, указанным в свойстве Value. Пример:

<GreaterThan Value="20"/>

<GreaterThan Source="{x:Definition resolution_width}" Value="20"/>

Условие «IsFalse»

Проверка, что значение является ложью. Пример:

<IsFalse Source="{x:Definition is_tablet}" />

Условие «IsTrue»

Проверка, что значение является истиной. Пример:

<IsTrue Source="{x:Definition is_smartphone}" />

Условие «IsNull»

Проверка, значение параметра на Null.

Условие «IsNullOrEmpty»

Проверка, что параметр имеет значение Null или пустое.

Условие «Length»

Задает длину значения, которое принимает параметр. Пример:

<Length MaxLength="512" />

Условие «LengthInRange»

Диапазон значений длины, которые принимает параметр. Может содержать параметры From, To. Пример:

<LengthInRange From="1" />

Условие «LessThan»

Сравнивает значение поля с указанным значением в свойстве Value. Пример:

<LessThan Value="320"/>

<LessThan Source="{x:Definition resolution_width}" Value="320"/>

Условие «Matches»

Проверяет текстовые значения регулярным выражением. Примеры:

<Matches Expression="^samsung\wM[\w]+"

  RegexOptions="IgnoreCase" />

<Matches Source="{x:Definition marketing_name}"

  Expression="^samsung\wM[\w]+"

  RegexOptions="IgnoreCase" />

<Must>

  <If>

  <And>

  <!--поддержка логических операндов для условий-->

  <GreaterThan Source="{x:Definition Age}" Value="16" />

  <Or>

  <IsNullOrEmpty Source="{x:Definition Passport}" />

  <Not>

  <!--поддержка Regex условий-->

  <Matches Source="{x:Definition Passport}"

  Expression="[0-9]{4} [0-9]{6}"

  RegexOptions="IgnoreCase, CultureInvariant" />

  </Not>

  </Or>

  </And>

  <If. True>

  <WithMessage Text="{x:Resource msg_Pass}" />

  </If. True>

  </If>

</Must>

Условие «MatchesForEachLine»

Многострочная проверка регулярным выражением. Пример:

<ForMember Definition="{x:Definition String_Field3}">
  <If>
  <Or>
  <IsNullOrEmpty />
  <MatchesForEachLine Trim="True" Expression="^[0-9]+$" />
  </Or>
  <If. False>
  <WithMessage Text="failure" />
  </If. False>
  </If>
</ForMember>

Пример валидации мета-тегов:

<ForMember Definition="{x:Definition String_Field}">
  <If>
  <!--установка свойства Condition (оно указано как ContentProperty)-->
  <Or>
  <IsNullOrEmpty />
  <MatchesForEachLine Expression="^<meta[ ]+((name[ ]*=[ ]*"([\w\-])+"[
]+)|(content[ ]*=[ ]*"([\w\-;\.,=\\/? ])+"[ ]+)|(http-equiv[ ]*=[ ]*"([\w\-])+"[
]+))+/>$"
  RegexOptions="IgnoreCase, CultureInvariant"
  Trim="True" />
  </Or>
  <If. False>
  <WithLocalizedMessage Text="Введенный текст не является мета-тегами">
  <x:String x:Key="ru-ru">Введенный текст не является мета-тегами</x:String>
  <x:String x:Key="en-us">Input is not a valid meta.</x:String>
  </WithLocalizedMessage>
  </If. False>
  </If>
</ForMember>

Условие «SatisfyExpression»

Условие, в котором можно указать лямбда-выражение в формате Dynamic LINQ.

Пример проверки даты:

<ForMember Definition="{x:Definition Date}">

  <If>

  <SatisfyExpression>Convert. ToDateTime(Value) >= DateTime. Now</SatisfyExpression>

  <If. False>

  <!--действие для сообщения об ошибке валидации-->

  <WithMessage Text="дата должна быть не позднее текущей" />

  </If. False>

  </If>

</ForMember>

Пример проверки, что поле имеет нечётное значение и больше 10:

<ForMember Definition="{x:Definition Age}">

  <If>

  <SatisfyExpression>

  <![CDATA[

  Int32(Value) % 2 == 1 && Int32(Model["Age"]) > 10

  ]]>

  </SatisfyExpression>

  <If. False>

  <!--действие для сообщения об ошибке валидации-->

  <WithMessage Text="должно быть нечетное и больше 10" />

  </If. False>

  </If>

</ForMember>

Условие «IsEmail»

Проверяет, является ли параметр адресом электронной почты. Проверяемое значение должно соответствовать регулярному выражению:

"^[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$"

Условие «IsJson»

Проверяет, что значение может быть без ошибок десериализовано в формат JSON.

Условие «IsAbsoluteUrl»

Проверяет, является ли значение параметра абсолютным адресом. Проверяемое значение должно соответствовать регулярному выражению:

"^htt(p|ps)://(([a-z|A-Z|0-9|-|_]+).+)\.[a-z]{1,5}(|\?.+)$".

Действия

Название	Описание
WithMessage	Данные по ошибке валидации
WithLocalizedMessage	Данные по ошибке валидации с возможностью локализации сообщения об ошибке
WithValueFormattedMessage	Данные по ошибке валидации с возможностями локализации и вывода значения поля. Есть поддержка {0}.

Пример:

<WithLocalizedMessage Text="Превышена максимально допустимая длина (700 символов)">

<x:String x:Key="en-us">The maximum length is exceeded (700 characters).</x:String>

</WithLocalizedMessage>

Remote-валидация

В QP существует возможность использовать remote-валидацию, расширяющую возможности обычной валидации. В Remote-валидации выполняются дополнительные запросы к базе данных. Это позволяет валидировать соответствие статей и их связей определенной схеме данных.

Введённые пользователем данные передаются на проверку стороннему приложению в формате JSON.

Адрес стороннего приложения, предназначенного для выполнения валидации, рекомендуется задать на уровне сайта в словаре динамических ресурсов (параметр «Словари для валидации XAML»). В этом же параметре следует задать сопоставление ключей и адресов, используемых валидаторов: