时创建自定义控件,您通常会发现它需要调试其设计时行为。 这是如果自定义设计器创作自定义控件尤其如此。 有关详细信息,请参阅演练:创建 Windows 窗体控件都使用了 Visual Studio 设计时功能。
您可以调试使用 Visual Studio 中,您自定义控件,就像就像调试任何其他.NET Framework 类。 不同之处是待调试正在运行自定义控件的代码的 Visual Studio 的单独实例
本演练涉及以下任务:
-
创建用于承载自定义控件的 Windows 窗体项目
-
创建控件库项目
-
将属性添加到自定义控件
-
将自定义控件添加到主机窗体
-
设置设计时调试项目
-
在设计时调试自定义控件
完成后,必须了解调试自定义控件的设计时行为所需的任务。
创建项目
第一步是创建应用程序项目。 将使用此项目以生成承载自定义控件的应用程序。
在 Visual Studio 中,创建一个名为"DebuggingExample"的 Windows 应用程序项目 (文件 > 新建 > 项目 > 可视化C# 或Visual Basic > 经典桌面 > Windows 窗体应用程序).
创建控件库项目
-
添加Windows 控件库到解决方案。
-
添加一个新UserControl DebugControlLibrary 项目项。 有关详细信息,请参阅如何:添加新项目项。 新的源文件基名称指定为"DebugControl"。
-
使用解决方案资源管理器,通过删除代码文件的基名称中删除项目的默认控件"
UserControl1"。 有关详细信息,请参阅如何:移除、 删除和排除项。 -
生成解决方案。
检查点
此时,你将能够查看自定义控件工具箱。
若要检查您的进度,查找名为新选项卡DebugControlLibrary 组件并单击以选择它。 在打开时将看到控件列为DebugControl使用其旁边的默认图标。
将属性添加到自定义控件
若要演示自定义控件的代码运行在设计时,将添加一个属性,并实现属性的代码中设置断点。
-
打开DebugControl中代码编辑器。 将以下代码添加到类定义:
Private demoStringValue As String = Nothing <BrowsableAttribute(true)> Public Property DemoString() As String Get Return Me.demoStringValue End Get Set(ByVal value As String) Me.demoStringValue = value End Set End Propertyprivate string demoStringValue = null; [Browsable(true)] public string DemoString { get { return this.demoStringValue; } set { demoStringValue = value; } } -
生成解决方案。
将自定义控件添加到主机窗体
若要调试自定义控件的设计时行为,将主机窗体上将自定义控件类的一个实例。
-
在"DebuggingExample"项目中,打开在 Form1 Windows 窗体设计器。
-
在中工具箱,打开DebugControlLibrary 组件选项卡,将DebugControl拖到窗体的实例。
-
查找
DemoString中的自定义属性属性窗口。 请注意,您可以更改其值,就像任何其他属性。 此外请注意,当DemoString属性处于选中状态,该属性的描述字符串会显示在底部属性窗口。
设置项目以便进行设计时调试
若要调试自定义控件的设计时行为,将调试正在运行自定义控件的代码的 Visual Studio 的单独实例。
-
右键单击DebugControlLibrary项目中解决方案资源管理器,然后选择属性。
-
在中DebugControlLibrary属性表中,选择调试选项卡。
在中启动操作部分中,选择启动外部程序。 你将调试的单独实例的 Visual Studio 中,因此请单击省略号 (的 Visual Studio 属性窗口中的省略号按钮 (...)) 按钮以浏览 Visual Studio IDE。 可执行文件的名称是devenv.exe,如果已安装到默认位置,其路径为 %programfiles%\Microsoft Visual Studio 9.0\Common7\IDE\devenv.exe。
-
单击“确定”关闭对话框。
-
右键单击DebugControlLibrary项目,然后选择设为启动项目若要启用此调试配置。
在设计时调试自定义控件
现在已准备好调试自定义控件在设计模式下运行。 启动调试会话时,将创建 Visual Studio 的新实例,并且将以加载"DebuggingExample"解决方案。 当你打开中的 Form1窗体设计器,将创建并将开始运行自定义控件的实例。
-
打开DebugControl中的源文件代码编辑器,将断点放在
Set访问器的DemoString属性。 -
按 F5 启动调试会话。 请注意,创建 Visual Studio 的新实例。 你可以区分两种方法中的实例:
-
调试实例包含单词运行标题栏中
-
调试实例都有启动按钮及其调试禁用工具栏
在调试实例中设置断点。
-
-
在 Visual Studio 的新实例中,打开"DebuggingExample"解决方案。 您可以轻松地找到解决方案,通过选择最近使用的项目从文件菜单。 将列出"DebuggingExample.sln"解决方案文件,如最近使用的文件。
-
打开在 Form1窗体设计器,然后选择DebugControl控件。
-
更改
DemoString属性的值。 请注意,当提交更改时,Visual Studio 的调试实例获取焦点并且执行在断点处停止。 你可以单步执行属性访问器就像在任何其他代码一样。 -
在您完成与调试会话,请可以退出,请关闭 Visual Studio 的托管的实例,或单击停止调试调试实例中的按钮。
后续步骤
现在,可以在设计时调试自定义控件,有许多可能的扩展与 Visual Studio IDE 的控件的交互。
-
可以使用xref:System.ComponentModel.Component.DesignMode*属性的xref:System.ComponentModel.Component类来编写代码,将仅在设计时执行。 有关详细信息,请参阅 xref:System.ComponentModel.Component.DesignMode*。
-
有几个特性可应用于控件的属性,以处理与设计器的自定义控件的交互。 您可以找到这些属性在xref:System.ComponentModel?displayProperty=nameWithType命名空间。
-
自定义控件,可以编写自定义设计器。 这样,您对使用由 Visual Studio 公开可扩展设计器基础结构的设计体验的完全控制。 有关详细信息,请参阅演练:创建 Windows 窗体控件都使用了 Visual Studio 设计时功能。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
