Практическое руководство. Добавление локального свойства на экран Silverlight

Статья
06/10/2015

На экран можно добавить поле с именем local property. Локальное свойство можно использовать для сбора входного значения или отображения вычисляемого значения.

Создание локального свойства

В верхней части области Конструктор экрана щелкните Добавить элемент данных….

Откроется диалоговое окно Добавление элемента данных.
В диалоговом окне Добавление элемента данных выберите Локальное свойство.
Выберите тип локального свойства в раскрывающемся списке Тип.

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

Примечание

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

Диалоговое окно Добавление элемента данных закроется. В области Список элементов экрана появится локальное свойство.

Добавление локального свойства на экран

Перетащите локальное свойство из области Список элементов экрана в нужную область окна Дерево содержимого экрана.
В области Дерево содержимого экрана в раскрывающемся списке рядом с локальным свойством выберите требуемый тип отображения.

Например, если создается локальное свойство для отображения денежного значения, можно изменить его тип отображения в области Редактор денежных сумм или Средство просмотра денежных сумм. Кроме того, можно отображать строковое локальное свойство как элемент Текстовое поле или Подпись.

Применение правил проверки к локальному свойству

Выберите локальное свойство в области Список элементов экрана.
В окне Свойства разверните узел Проверка (если он еще не развернут).

Набор доступных правил проверки будет зависеть от типа локального свойства.
Если локальному свойству должно присваиваться значение, выберите параметр Является обязательным.

Выберите другие правила проверки, которые требуется применить к локальному свойству.
Если необходимо выполнить более сложные проверки, щелкните Настраиваемая проверка.

Откроется редактор кода. LightSwitch создает метод с именем localPropertyName_Validate. В этот метод можно добавить настраиваемую логику проверки. В следующем примере, когда пользователь вводит значение локального свойства CityCode, содержащее менее трех знаков, выводится сообщение об ошибке.
```
Private Sub CityCode_Validate(results As ScreenValidationResultsBuilder)
    If Me.CityCode.Length < 3 Then
        results.AddPropertyError("This string must have at least 3 letters.")
    End If 
End Sub
```
```
partial void CityCode_Validate
    (ScreenValidationResultsBuilder results)
{
    if (this.CityCode.Length < 3)
    {
        results.AddPropertyError("This string must have at least 3 letters.");
    }

}
```
Если строка содержит менее трех знаков, свойство будет выделено красным цветом и появится введенное выше сообщение об ошибке.

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

Локальному свойству можно присвоить значение с помощью кода.

В следующем примере локальному свойству ApprovedCheckBox присваивается значение False.

Private Sub OrdersListDetail_InitializeDataWorkspace _
    (saveChangesTo As System.Collections.Generic.List _
     (Of Microsoft.LightSwitch.IDataService))
    ApproveCheckBox = False 

End Sub

partial void ApprovedCheckBox_Validate
    (ScreenValidationResultsBuilder results)
{
    ApprovedCheckBox = false;

}

См. также

Задачи

Практическое руководство. Добавление пользовательской команды на экран Silverlight

Практическое руководство. Разработка экрана Silverlight с помощью конструктора экрана

Другие ресурсы

Экраны. Пользовательский интерфейс приложения LightSwitch

Поделиться через