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

Статья
02/20/2013

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

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

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

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

Можно также обработать проверку в LightSwitch, задав свойства проверки или написав пользовательский код проверки.

Установка свойств проверки

В Обозревателе решений дважды щелкните элемент Контакты.
В конструкторе данных щелкните пункт <Добавить свойство>, а затем введите значение ContactState.
Убедитесь, что указан тип String.
В окне Свойства выберите свойство Максимальная длина и введите значение 2.

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

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

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

Откроется Редактор кода, в котором будет отображаться блок кода для метода 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.");
}

Этот код обеспечивает невозможность сохранения значения меньше 1 в поле Количество.Если пользователь пытается сохранить значение меньше единицы, возникает ошибка проверки.

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

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

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

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