如果由当前打开的解决方案中的项目定义您的组件,它们将自动显示在工具箱,由你需执行任何操作。 可以手动填充工具箱与使用自定义组件选择工具箱项对话框 (Visual Studio),但工具箱考虑在解决方案中的项的生成包含所有以下特征的输出结果:
-
不具有xref:System.ComponentModel.ToolboxItemAttribute设置为
false; -
不具有xref:System.ComponentModel.DesignTimeVisibleAttribute设置为
false。
Note: 工具箱不遵循引用链,因此它不会显示并非由你的解决方案中的项目生成的项。
本演练演示如何自定义组件自动出现在工具箱生成组件后。 本演练涉及以下任务:
-
创建一个 Windows 窗体项目。
-
创建自定义组件。
-
创建自定义组件的实例。
-
卸载并重新加载自定义组件。
完成后,你将看到工具箱填充了已创建的组件。
创建项目
-
在 Visual Studio 中,创建一个名为基于 Windows 的应用程序项目
ToolboxExample(文件 > 新建 > 项目 > 可视化C# 或Visual Basic > 经典桌面 > Windows 窗体应用程序)。 -
向项目添加新组件。 将其命名为
DemoComponent。有关详细信息,请参阅如何:添加新项目项。
-
生成项目。
-
从工具菜单上,单击选项项。 单击常规下Windows 窗体设计器项,然后确保AutoToolboxPopulate选项设置为True。
创建自定义组件的实例
下一步是在窗体上创建自定义组件的实例。 因为工具箱自动为新的组件的帐户,这非常简单,只创建任何其他组件或控件。
-
打开中的项目的窗体窗体设计器。
-
在中工具箱,单击名为的新选项卡ToolboxExample 组件。
单击选项卡,会看到DemoComponent。
NOTE 出于性能原因中的自动填充区域的组件工具箱不显示自定义位图和xref:System.Drawing.ToolboxBitmapAttribute不受支持。 若要显示的图标中的自定义组件工具箱,使用选择工具箱项对话框以加载该组件。
-
将组件拖到窗体上。
创建并添加到组件的实例组件栏。
卸载并重新加载自定义组件
工具箱项目,会考虑在每个组件的加载和卸载一个项目时,它会删除对项目的组件的引用。
-
卸载该解决方案中的项目。
有关卸载的项目的详细信息,请参阅如何:卸载并重新加载项目。 如果系统提示您保存时,选择是。
-
添加一个新Windows 应用程序到解决方案。 打开中的窗体设计器。
ToolboxExample 组件选项卡上一个项目现已消失了。
-
重新加载
ToolboxExample项目。ToolboxExample 组件选项卡现在再次出现。
后续步骤
本演练演示工具箱会考虑项目的组件,但工具箱同时也会考虑的控件。 通过添加和删除控件项目从解决方案来测试您自己的自定义控件。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
