如何：將自訂控制項加入至 Silverlight 螢幕

發行項
06/10/2015

您可以將 Silverlight 控制項加入到 LightSwitch 畫面。您可以使用 Silverlight 控制項，透過比內建 LightSwitch 控制項功能更為優越的方式顯示或收集資訊。

您可以使用 Silverlight 執行階段和 Silverlight SDK 中所包含的控制項。您還可以使用您使用 Silverlight 專案範本 (例如，那些在 Visual Studio 2010 中提供的範本) 所建立的控制項。這兩種控制項在 LightSwitch 中都稱為「自訂控制項」(Custom Control)。

如需如何使用 Visual Studio 之 Silverlight 專案範本建立自訂控制項的詳細資訊，請參閱控制項基本 (Silverlight 快速入門)。

加入新控制項和取代現有控制項

您可以將自訂控制項加入至畫面，做為新的控制項，或是取代現有的 LightSwitch 控制項。

若要將自訂控制項加入至畫面

在 [畫面內容樹狀結構] 中選取任何群組。
在 [畫面設計工具] 頂端按一下 [加入配置項目]，然後按一下 [自訂控制項]。

在 [加入自訂控制項] 對話方塊中，依序展開組件節點和命名空間節點，然後選取控制節點。

如果所需的組件未在 [加入自訂控制項] 對話方塊中出現，請按一下 [加入參考]。在 [加入參考] 對話方塊中，選取組件或包含所要使用之控制項的本機專案，然後按一下 [確定]。

注意事項
如果您使用 Visual Studio 中的 Silverlight 專案範本建立此控制項，並修改控制項的 XAML 將控制項繫結至資料，則不必執行下一個步驟。如需如何利用修改控制項的 XAML 繫結自訂控制項到資料的詳細資訊，請參閱使用自訂控制項來加強 LightSwitch 應用程式 UI。如果自訂控制項是內建的 Silverlight 控制項，或者您使用 Visual Studio 中的 Silverlight 專案範本建立此控制項，但是想要使用 LightSwitch 將控制項繫結至資料，請繼續執行下一個步驟。

如果您使用 Visual Studio 中的 Silverlight 專案範本建立此控制項，並修改控制項的 XAML 將控制項繫結至資料，則不必執行下一個步驟。如需如何利用修改控制項的 XAML 繫結自訂控制項到資料的詳細資訊，請參閱使用自訂控制項來加強 LightSwitch 應用程式 UI。如果自訂控制項是內建的 Silverlight 控制項，或者您使用 Visual Studio 中的 Silverlight 專案範本建立此控制項，但是想要使用 LightSwitch 將控制項繫結至資料，請繼續執行下一個步驟。

在 [指定新自訂控制項的資料] 欄位中，輸入要繫結至控制項之畫面資料的名稱，然後按一下 [確定]。

例如，如果您想要讓自訂清單方塊顯示名為 CustomerSet 之集合中的名稱，請輸入 CustomerSet。如果您希望控制項顯示目前所選客戶的名稱，請輸入 CustomerSet.SelectedItem.ContactName。
加入將資料繫結至控制項之特定屬性的程式碼。如需詳細資訊，請參閱本文件稍後的將資料繫結至自訂控制項的屬性。

若要使用自訂控制項取代現有控制項

在 [畫面內容樹狀結構] 中，在您要取代的控制項旁邊的下拉式清單中選取 [自訂控制項]。
在 [屬性] 視窗中，按一下 [自訂控制項] 的 [變更]
在 [加入自訂控制項] 對話方塊中，依序展開組件節點和命名空間節點，並選取控制節點，然後按一下 [確定]。

如果包含控制項的組件未在 [加入自訂控制項] 對話方塊中出現，請按一下 [加入參考]。在 [加入參考] 對話方塊中，選取組件或包含所要使用之控制項的本機專案，然後按一下 [確定]。
加入將資料繫結至控制項之特定屬性的程式碼。如需詳細資訊，請參閱本文件稍後的將資料繫結至自訂控制項的屬性。

將資料繫結至自訂控制項的屬性

您必須將您在 [加入自訂控制項] 對話方塊中指定的資料繫結至自訂控制項的特定屬性。

若要將資料繫結至自訂控制項的屬性

在 [畫面設計工具] 中，按一下 [撰寫程式碼] 按鈕旁邊的箭頭，然後按一下任何方法。

注意事項

選擇要在資料顯示於執行階段控制項之前執行的方法，例如 CustomerListDetail_Activated。

方法區塊將會在 [程式碼編輯器] 中出現。

注意事項
選擇要在資料顯示於執行階段控制項之前執行的方法，例如 CustomerListDetail_Activated。

在方法區塊中，加入會將畫面資料繫結至自訂控制項之屬性的程式碼。

下列範例會參考名為 Customers 的自訂清單方塊控制項。此程式碼會將 [加入自訂控制項] 對話方塊中指定的資料集合繫結至清單方塊的特定屬性。此程式碼還會指定可以使用此控制項修改資料。

Private Sub CustomersListDetail_Activated()
    Me.FindControl("Customers").SetBinding( _
        System.Windows.Controls.ListBox.ItemsSourceProperty, _
                "Value", System.Windows.Data.BindingMode.TwoWay)
End Sub

partial void CustomersListDetail_Activated()
{
    this.FindControl("Customers").SetBinding(
        System.Windows.Controls.ListBox.ItemsSourceProperty,
        "Value", System.Windows.Data.BindingMode.TwoWay);
}