共用方式為

如何：將區域屬性加入至 Silverlight 螢幕

  • 發行項

您可以將名為 本機屬性 的欄位加至畫面。 您可以使用區域屬性，收集輸入值或顯示計算值。

若要建立區域屬性

  1. 按一下 [畫面設計工具] 頂端的 [加入資料項目…]。

    [加入資料項目] 對話方塊隨即出現。

  2. 在 [加入資料項目] 對話方塊中，選取 [區域屬性]。

  3. 在 [型別] 下拉式清單中，選取區域屬性的型別。

    您可以選取任何標準類型 (例如 [字串]、[整數]、[電子郵件地址]) 或任何與應用程式相關聯的實體 (例如 [客戶]、[訂單詳細資料] 或 [產品])。

  4. 如果您希望此欄位必須包含值，請選取 [是必要項]。

    注意事項注意事項

    當使用者嘗試開啟畫面時，如果此欄位沒有包含值，則會出現驗證訊息。

  5. 在 [名稱] 文字方塊中輸入名稱，然後按一下 [確定]。

    [加入資料項目] 對話方塊將會關閉。 區域屬性會在 [畫面成員清單] 中出現。

若要將區域屬性加入至畫面

  1. 將區域屬性從 [畫面成員清單] 拖曳至 [畫面內容樹狀結構] 的指定位置。

  2. 在 [畫面內容樹狀結構] 中，從區域屬性旁顯示的下拉式清單選取所需的顯示類型。

    例如，如果您要建立區域屬性以顯示貨幣值，則可以將其顯示類型變更為 [金錢編輯器] 或 [金錢檢視器]。 同樣的，您可以將字串的區域屬性顯示為 [文字方塊] 或 [標籤]。

若要將驗證規則套用至區域屬性

  1. 在 [畫面成員清單] 中，選取區域屬性。

  2. 展開 [屬性] 視窗中的 [驗證] 節點 (如果尚未展開)。

    可用的驗證規則會因區域屬性的類型而異。

  3. 如果區域屬性必須有值，請選取 [是必要項]。

    選取您要套用至區域屬性的任何其他驗證規則。

  4. 如果您需要執行更複雜的驗證，請按一下 [自訂驗證]。

    [程式碼編輯器] 隨即出現。 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 螢幕

其他資源

螢幕：應用程式的使用者介面