在 LightSwitch 中自訂實體欄位

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

在本課程中,您將學習如何在 LightSwitch 中為資料實體中的欄位設定屬性及變更資料類型。

藉由設定實體在螢幕上使用時的 [Summary Property],您可以指定用來描述實體類型的欄位。 例如,[連絡人] 實體的預設 [Summary Property] 是 [ID] 欄位。 在此情況下,最好將 [Summary Property] 設為具有更有意義之名稱的欄位, 例如 [CompanyName]。

設定摘要屬性

  1. 在 [方案總管] 中,開啟 [Customers.lsml] 節點的捷徑功能表,然後選擇 [開啟]。

    [資料設計工具] 隨即開啟。

  2. 在 [透視圖] 列中,選擇 [HTMLClient] 索引標籤。

  3. 在 [屬性] 視窗中,選擇 [摘要屬性] 清單中的 [CompanyName]。

藉由設定顯示屬性,您可以指定向使用者顯示指定欄位資料的方式。 例如,當您向使用者顯示名為 CompanyName 的欄位時,可能只想顯示 “Company”。

變更顯示名稱

  1. 在 [資料設計工具] 中,選擇 [CompanyName] 欄位。

  2. 在 [屬性] 視窗中,選擇 [顯示名稱] 屬性,然後在文字方塊中輸入 Company。

藉由設定欄位的 [Description] 屬性,您可以提供要向使用者顯示的文字,以做為執行中應用程式的工具提示。

設定描述屬性

  1. 在 [資料設計工具] 中,選擇 [ContactName] 欄位。

  2. 在 [屬性] 視窗中,選擇 [ContactName] 屬性文字方塊,然後在文字方塊中輸入 This is our primary contact at this company (這是本公司的主要連絡人)。

    當使用者指向某個欄位時,[描述] 屬性值會顯示為應用程式中的工具提示。

資料庫資料表中的欄位通常會儲存為對資料庫有效率的格式,但這可能不是您想向使用者顯示的格式。 例如,表示貨幣值的欄位通常會儲存為 Decimal 資料類型。 為了顯示,我們通常會使用貨幣符號和正確的小數位數來格式化值。

變更資料類型

  1. 在 [方案總管] 中,開啟 [客戶] 節點的捷徑功能表,然後選擇 [開啟]。

  2. 在 [資料設計工具] 的 [透視圖] 列上,選擇 [Server] 索引標籤。

  3. 在 [屬性] 視窗中,選擇 [ContactName] 屬性文字方塊,然後在文字方塊中輸入 This is our primary contact at this company (這是本公司的主要連絡人)。

    當使用者指向某個欄位時,[描述] 屬性值會顯示為應用程式中的工具提示。

  4. 在 [類型] 欄中開啟清單,然後選擇 [PhoneNumber]。

    [PhoneNumber] 是一種自訂的商務類型,以標準化格式顯示電話號碼。 您可以選擇 [電話號碼格式] 屬性,以指定應用程式的有效格式。

  5. 在 [方案總管] 中,開啟 [Order_Details] 節點的捷徑功能表,然後選擇 [開啟]。

  6. 在 [資料設計工具] 的 [透視圖] 列上,選擇 [Server] 索引標籤。

  7. 選擇 [UnitPrice] 欄位。

  8. 在 [類型] 欄中開啟清單,然後選擇 [Money]。

    [Money] 是可格式化及顯示貨幣值的另一種自訂商務類型。

  9. 在 [屬性] 視窗中,選擇 [貨幣符號] 屬性,然後在文字方塊中輸入 $

  10. 選擇 [小數位數] 屬性,然後在文字方塊中輸入 2

在本課程中,您為實體欄位設定了屬性,並且變更了欄位的資料類型。 最佳作法是在加入實體之後立即自訂顯示屬性和資料類型,不過您可以在開發應用程式期間隨時執行這項操作。

您設定的第一個屬性是 [摘要] 屬性。 若是包含清單的螢幕,清單中會顯示此欄位,而不是預設 [ID] 欄位。

資料庫欄位名稱不可以包含空格,因此有時會使用底線字元來表示空格。 為了確保向使用者顯示的欄位名稱簡明易懂,您可以在 LightSwitch 中修訂欄位名稱並加入空格。 若要執行這項操作,請檢閱資料庫實體中的欄位名稱,然後針對需要更佳顯示名稱的任何欄位,變更其 [顯示名稱] 屬性。

您可以設定的大多數屬性與外觀相關,其他屬性則設定驗證規則及其他特性。 屬性的可用性會隨資料類型而有所不同。 稍後的課程將描述其他屬性。

藉由使用自訂資料類型,您可以最適合應用程式的方式來呈現資料,而不需要變更基礎資料庫中的類型。 例如,Money 自訂類型會將資料庫中的小數點格式轉換為要顯示的貨幣格式,而資料庫則保留其有效率的小數點格式。 許多自訂資料類型提供類型特有的屬性。 例如,Money 類型的 [Currency Symbol] 屬性決定向使用者顯示貨幣的方式。

除了 PhoneNumberMoney 自訂商務類型之外,LightSwitch 還提供 EmailAddressHyperlinkPercentageWeb AddressImage 類型。

System_CAPS_ICON_note.jpg 注意

影像通常會以 Binary 資料類型儲存在資料庫中。 您無法顯示 Binary 類型,不過您可以將其變更為 Image 類型加以顯示。

在下一個課程中,您將學習如何向使用者顯示預先決定的值清單。 下一個課程:顯示選擇清單

使用資料
如何:定義資料欄位
如何:驗證資料
擴充功能:為 LightSwitch 新增功能

顯示: