如何：向 Silverlight 屏幕添加局部属性

2013-02-21

您可以添加将名为“地产”的字段添加到屏幕。您可以使用本地属性来收集输入的值或显示计算出的值。

创建本地属性

从**“屏幕设计器”的顶部单击“添加数据项…”**。

此时将出现“添加数据项”对话框。
在**“添加数据项”对话框中，选择“本地属性”**。
从**“类型”**下拉列表中选择当地属性类型。

您可以选择任何标准类型（如**“字符串”、“整数”和“电子邮件地址”），或任何与您的应用程序相关联的实体，如“客户”、“订单详细信息”或“产品”**。
如果您想要求此字段包含一个值，请选择**“必需”**。

说明

如果此字段不包含值，当用户试图打开屏幕时，会出现一条验证消息。
在**“名称”文本框中，键入一个名称，然后单击“确定”**。

**“添加数据项”对话框将关闭。本地属性将显示在“屏幕成员列表”**中。

说明
如果此字段不包含值，当用户试图打开屏幕时，会出现一条验证消息。

向屏幕添加本地属性

将本地属性从**“屏幕成员名单”拖到“屏幕内容树”**所需的位置。
在**“屏幕内容树”**的本地属性旁边出现的下拉列表中，选择想要的显示类型。

例如，如果您正在创建本地的属性来显示货币值，您可以将其显示类型更改为**“货币编辑器”或“货币查看器”。同样，您可以将字符串本地属性显示为“文本框”或“标签”**。

将有效性规则应用于本地属性

在**“屏幕成员列表”**中，选择本地属性。
从**“属性”窗口展开“验证”**节点，如果尚未展开。

可用的验证规则将取决于当地的属性的类型。
如果本地的属性必须有一个值，请选择**“必需”**。

选择您要应用于本地属性的任何其他验证规则。
如果您需要执行更复杂的验证，请单击**“自定义验证”**。

显示代码编辑器。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 屏幕

其他资源

屏幕：应用程序的用户界面