建立 WPF 工具箱控制項

發行項
02/29/2024

使用 WPF (Windows Presentation Framework) 工具箱控制項範本，可讓您建立 WPF 控制項，在安裝延伸模組時自動新增到 [工具箱]。本逐步解說說明如何使用範本建立可散發給其他使用者的 [工具箱] 控制項。

建立工具箱控制項

使用 WPF 工具箱控制項建立延伸模組

建立名為 MyToolboxControl 的 VSIX 應用程式專案。您可以在 [新增專案] 對話方塊中搜尋「vsix」來尋找 VSIX 專案範本。
當專案開啟時，新增名為 MyToolboxControl 的 [WPF 工具箱控制項] 項目範本。在 [方案總管] 中，以滑鼠右鍵按一下專案節點，並選取 [新增]>[新增項目]。在 [新增專案] 對話方塊中，移至 [Visual C#]>[擴充性]，然後選取 [WPF 工具箱控制項]。在視窗底部的 [名稱] 欄位中，將命令檔名變更為 MyToolboxControl.cs。

方案現在包含一個使用者控制項、一個將控制項新增至 [工具箱] 的 ProvideToolboxControlAttributeRegistrationAttribute，以及 VSIX 資訊清單中一個用於部署的 Microsoft.VisualStudio.ToolboxControl 資產專案。

建立控制項 UI

在設計工具中開啟 MyToolboxControl.xaml。

設計工具會顯示包含了 Button 控制項的 Grid 控制項。
排列方格配置。當您選取 Grid 控制項時，藍色控制項橫條會出現在方格的上邊緣和左邊緣。您可以按下橫條，將資料列和資料行新增至方格。
將子控制項新增至方格。您可以將子控制項從 [工具箱] 拖曳至方格的區段，或在 XAML 中設定其 Grid.Row 和 Grid.Column 屬性，來放置子控制項。下列範例會在方格的頂端資料列加上兩個標籤，並在第二列新增一個按鈕。
```
<Grid>
    <Label Grid.Row="0" Grid.Column="0" Name="label1" />
    <Label Grid.Row="0" Grid.Column="1" Name="label2" />
    <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
</Grid>
```

重新命名控制項

根據預設，您的控制項將會在 [工具箱] 中以 MyToolboxControl 的形式出現在名為 MyToolboxControl.MyToolboxControl 的群組中。您可以在 MyToolboxControl.xaml.cs 檔案中變更這些名稱。

在程式碼檢視中開啟 MyToolboxControl.xaml.cs。
尋找 MyToolboxControl 類別，並將它重新命名為 TestControl。 (執行此動作的最快方式是重新命名類別，然後從操作功能表選取 [重新命名] 並完成各個步驟。 (如需有關 [重新命名] 命令的詳細資訊，請參閱重新命名重構 (C#))。
移至 ProvideToolboxControl 屬性，並將第一個參數的值變更為 Test。這是將在 [工具箱] 中包含該控制項的群組名稱。

產生的程式碼應該如下所示：
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

建置、測試和部署

當您對專案進行偵錯時，應該會在 Visual Studio 實驗執行個體的 [工具箱] 中找到已安裝的控制項。

建置和測試控制項

重建此專案並開始偵錯。
在 Visual Studio 的新執行個體中建立 WPF 應用程式專案。確定 XAML 設計工具已開啟。
在 [工具箱] 中尋找控制項，並將它拖曳至設計介面。
開始對 WPF 應用程式進行偵錯。
確認您的控制項有出現。

部署內容

建置測試專案之後，可以在專案的 *\bin\debug* 資料夾中找到 .vsix 檔案。
您可以按兩下 .vsix 檔案並遵循安裝程序將它安裝在本機電腦上。若要解除安裝控制項，請移至 [工具]>[延伸模組和更新] 並尋找控制項延伸模組，然後按一下 [解除安裝]。
將 .vsix 檔案上傳到網路或網站。

如果將檔案上傳到 Visual Studio Marketplace 網站，其他使用者就可以在 Visual Studio 中使用 [工具]>[延伸模組和更新] 在線上尋找並安裝控制項。