Проверка данных в приложении LightSwitch

Статья
06/10/2015

На этом занятии рассматриваются способы проверки данных, которые пользователь вводит в приложении LightSwitch. Например, в приложении LightSwitch можно проверить количество цифр в телефонном номере или наличие значения в обязательном поле.

Добавление проверки данных

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

Конструктор данных содержит пример одного вида проверки: для каждого поля сущности имеется флажок Обязательно. Если поле не содержит значение, но отмечено как обязательное, при попытке сохранить данные в LightSwitch выводится предупреждение.

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

Задание минимального и максимального значения

В области Обозреватель решений откройте контекстное меню для узла Contacts.lsml и выберите Открыть.
В области Конструктор данных на панели Перспектива перейдите на вкладку Сервер.
Выберите ссылку <Добавить свойство> и введите ContactState.
В столбце Тип выберите String.
В столбце Обязательно снимите флажок, чтобы пометить свойство ContactState как необязательное.
В окне Свойства задайте для свойства Максимальная длина значение 2.

Этот параметр гарантирует, что в поле ContactState пользователи смогут ввести не более двух знаков.

Добавление пользовательского кода проверки

В области Обозреватель решений откройте контекстное меню для узла Order_Details.lsml и выберите Открыть.
В области Конструктор данных на панели Перспектива перейдите на вкладку Сервер и выберите поле Количество.
В окне Свойства выберите ссылку Настраиваемая проверка.

Откроется редактор кода, в котором будет отображаться блок кода для метода Quantity_Validate.
Добавьте следующий код в метод Quantity_Validate сразу под строкой комментария.

Предупреждение

Добавьте код Visual Basic или C# в зависимости от языка программирования, который был выбран при создании проекта.
```
If Quantity < 1 Then
    results.AddPropertyError("Quantity must be greater than zero.")
End If
```
```
if (Quantity < 1) 
{
    results.AddPropertyError("Quantity must be greater than zero.");
}
```
Этот код будет вызывать ошибку проверки, если пользователь попытается сохранить значение, которое меньше значения в поле Количество.

Подробный обзор

На этом занятии были рассмотрены способы проверки данных путем настройки свойств проверки или создания кода проверки. Для разных типов данных можно задать разные свойства. Например, тип String имеет свойство Максимальная длина, а тип Integer — свойства Минимальное значение и Максимальное значение. Все типы имеют свойство Является обязательным, которое используется для флажка Обязательное в конструкторе данных.

Свойства проверки для сущности Клиенты отображаются затемненными и не могут быть изменены. Некоторые поля, такие как Адрес, уже имеют значение в свойстве Максимальная длина. Невозможно задать свойства проверки для сущности из присоединенного источника данных; это возможно только в созданных вами сущностях.

Чтобы добавить проверку сущности из присоединенного источника данных, следует написать собственный код проверки. Существующие свойства проверки можно переопределить только при условии добавления более строгой проверки. Например, для поля, для которого значение свойства Максимальная длина равно 30, невозможно добавить код проверки, задающий длину равной 40. Однако можно добавить код для ограничения длины до менее чем 30 знаков.