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

Статья
02/20/2013

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

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

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

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

Можно выбрать любой из стандартных типов, таких как String, Integer, Email Address или любую из сущностей, которые связаны с приложением, например Customer, Order Detail или Product.

Выберите параметр Обязательное, если поле должно обязательно содержать значение.

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

В текстовом поле Имя введите имя и нажмите кнопку ОК.

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

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

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

Например, если создается локальное свойство для отображения денежного значения, можно изменить его тип отображения на Money Editor или Money Viewer.Кроме того, можно отображать строковое локальное свойство как элемент Text Box или Label.

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

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

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

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

Откроется редактор кода.В 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 с помощью конструктора экрана

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

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

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