创建 WPF 工具箱控件

WPF (Windows Presentation Framework) 工具箱控件模板允许您创建 WPF 控件，会自动添加到 工具箱 安装扩展的安装。本主题演示如何使用模板来创建 工具箱 可以分发给其他用户的控件。

创建 WPF 工具箱控件

与 WPF 工具箱控件中创建的扩展

创建一个名为的 VSIX 项目 MyToolboxControl。您可以找到中的 VSIX 项目模板 新项目 下的对话框 Visual C# / 可扩展性。
在打开该项目，添加 WPF 工具箱控件 项模板名为 MyToolboxControl。在 解决方案资源管理器, ，用鼠标右键单击项目节点并选择 添加 / 新项。在 添加新项 对话框中，转到 Visual C# / 可扩展性 ，然后选择 WPF 工具箱控件。在名称在窗口的底部字段中，命令文件名称更改为 MyToolboxControl.cs。

该解决方案现在包含一个用户控件， ProvideToolboxControlAttribute RegistrationAttribute ，将控件添加到工具箱, ，和一个 Microsoft.VisualStudio.ToolboxControl 资产部署的 VSIX 清单中的条目。

若要创建控件用户界面

在设计器中打开 MyToolboxControl.xaml。

此设计器显示包含 Button 控件的 Grid 控件。
排列网格布局。当您选择 Grid 控制，网格的顶部和左侧边缘上显示蓝色的控件条。您可以添加到网格的行和列，方法是单击标题栏。
将子控件添加到网格。您可以通过将其从拖动定位子控件 工具箱 部分的网格中，或通过设置其 Grid.Row 和Grid.Column 在 XAML 中的属性。下面的示例在网格中，然后第二行上的按钮的顶行上添加两个标签。
```
<Grid>
    <Label Grid.Row="" Grid.Column="" Name="label1" />
    <Label Grid.Row="" Grid.Column="" Name="label2" />
    <Button Name="button1" Click="button1_Click" Grid.Row="" Grid.ColumnSpan="" />
</Grid>
```
重命名控件

默认情况下，您的控件将出现在 工具箱 作为 MyToolboxControl 中一个名为组MyToolboxControl.MyToolboxControl。您可以更改这些名称 MyToolboxControl.xaml.cs 文件中。

在代码视图中打开 MyToolboxControl.xaml.cs。
查找 MyToolboxControl 类并将它重命名为 TestControl。 (若要这样做的最快方法是重命名类中，然后选择 重命名从上下文菜单并完成的步骤。 (有关详细信息 重命名 命令，请参阅重命名重构 (C#)。)

转到 ProvideToolboxControl 属性并更改的第一个参数的值测试。这是将包含控件中的组的名称 工具箱。

生成的代码应如下所示︰

[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 库网站，其他用户可以使用 工具 / 扩展和更新 在 Visual Studio 中查找联机的控件并将其安装。

创建 WPF 工具箱控件

启动 Visual Studio 2015 中，您并不安装 Visual Studio SDK 从下载中心获得。它将包括作为 Visual Studio 安装程序中的可选功能。您还可以在以后安装 VS SDK。有关更多信息，请参见安装 Visual Studio SDK。

创建 WPF 工具箱控件

与 WPF 工具箱控件中创建的扩展

创建一个名为的 VSIX 项目 MyToolboxControl。您可以找到中的 VSIX 项目模板 新项目 下的对话框 Visual C# / 可扩展性。
在打开该项目，添加 WPF 工具箱控件 项模板名为 MyToolboxControl。在 解决方案资源管理器, ，用鼠标右键单击项目节点并选择 添加 / 新项。在 添加新项 对话框中，转到 Visual C# / 可扩展性 ，然后选择 WPF 工具箱控件。在名称在窗口的底部字段中，命令文件名称更改为 MyToolboxControl.cs。

该解决方案现在包含一个用户控件， ProvideToolboxControlAttribute RegistrationAttribute ，将控件添加到工具箱, ，和一个 Microsoft.VisualStudio.ToolboxControl 资产部署的 VSIX 清单中的条目。

若要创建控件用户界面

在设计器中打开 MyToolboxControl.xaml。

此设计器显示包含 Button 控件的 Grid 控件。
排列网格布局。当您选择 Grid 控制，网格的顶部和左侧边缘上显示蓝色的控件条。您可以添加到网格的行和列，方法是单击标题栏。
将子控件添加到网格。您可以通过将其从拖动定位子控件 工具箱 部分的网格中，或通过设置其 Grid.Row 和Grid.Column 在 XAML 中的属性。下面的示例在网格中，然后第二行上的按钮的顶行上添加两个标签。
```
<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>
```

重命名控件

生成、测试和部署