大网数据广告活动
.NET 与 C# 开发

演练:使用 Visual C# 从 Windows 窗体控件继承

· 52CE 我爱测

通过视觉对象C#,可以创建功能强大的自定义控件,通过*继承*。 通过继承,可以创建不仅保留了标准 Windows 窗体控件的所有固有功能,而且还包含自定义功能的控件。 在本演练中,将创建一个名为 ValueButton 的简单继承控件。 此按钮将继承标准 Windows 窗体的功能控件,并将公开一个名为的自定义属性ButtonValue。

通过视觉对象C#,可以创建功能强大的自定义控件,通过继承。 通过继承,可以创建不仅保留了标准 Windows 窗体控件的所有固有功能,而且还包含自定义功能的控件。 在本演练中,将创建一个名为 ValueButton 的简单继承控件。 此按钮将继承标准 Windows 窗体的功能xref:System.Windows.Forms.Button控件,并将公开一个名为的自定义属性ButtonValue。

Note: 显示的对话框和菜单命令可能会与“帮助”中的描述不同,具体取决于你现用的设置或版本。 若要更改设置,请在 “工具” 菜单上选择 “导入和导出设置” 。 有关详细信息,请参阅个性化设置 Visual Studio IDE。

创建项目

创建新的项目时应指定其名称,以设置根命名空间、程序集名称和项目名称,并确保默认组件将位于正确的命名空间中。

创建 ValueButtonLib 控件库和 ValueButton 控件
  1. 在“文件”菜单上指向“新建”,然后单击“项目”打开“新建项目”对话框。

  2. 选择Windows 窗体控件库项目模板从列表中的 Visual C# 项目,然后键入ValueButtonLib中名称框。

    默认情况下,项目名称 ValueButtonLib 也会分配到根命名空间中。 根命名空间用于限定程序集中的组件名。 例如,如果两个程序集都提供名为 ValueButton 的组件,则可以使用 ValueButtonLib.ValueButton 指定 ValueButton 组件。 有关详细信息,请参阅命名空间。

  3. 在“解决方案资源管理器”中,右键单击“UserControl1.cs”,然后从快捷菜单中选择“重命名”。 将文件名更改为 ValueButton.cs。 询问是否希望重命名对代码元素“”的所有引用时,单击“是”UserControl1按钮。

  4. 在“解决方案资源管理器”中,右键单击“ValueButton.cs”并选择“查看代码”。

  5. 找到class语句行public partial class ValueButton,并将该控件从从中要继承的类型更改xref:System.Windows.Forms.UserControl到xref:System.Windows.Forms.Button。 这允许继承的控件继承的所有功能xref:System.Windows.Forms.Button控件。

  6. 在“解决方案资源管理器”中打开“ValueButton.cs”节点,以显示设计器生成的代码文件 ValueButton.Designer.cs。 在“代码编辑器”中打开此文件。

  7. 找到InitializeComponent方法,并删除的行,将分配xref:System.Windows.Forms.ContainerControl.AutoScaleMode*属性。 此属性中不存在xref:System.Windows.Forms.Button控件。

  8. 在“文件”菜单中,选择“全部保存”以保存项目。

    NOTE 可视化设计器不再可用。 因为xref:System.Windows.Forms.Button控件不自行绘制,则无法在设计器中修改其外观。 其可视表示形式将完全从它继承的类相同 (即, xref:System.Windows.Forms.Button) 除非在代码中修改。 但仍然可以向设计器图面添加不含 UI 元素的组件。

将属性添加到继承控件

继承的 Windows 窗体控件的可能用途之一是创建与标准 Windows 窗体控件的外观和感受相同、但公开自定义属性的控件。 在本节中,将向控件中添加名为 ButtonValue 的属性。

添加 Value 属性
  1. 在“解决方案资源管理器”中,右键单击“ValueButton.cs”,然后从快捷菜单中单击“查看代码”。

  2. 找到 class 语句。 紧接 { 之后键入以下代码:

    // Creates the private variable that will store the value of your   
    // property.  
    private int varValue;  
    // Declares the property.  
    public int ButtonValue  
    {  
       // Sets the method for retrieving the value of your property.  
       get  
       {  
          return varValue;  
       }  
       // Sets the method for setting the value of your property.  
       set  
       {  
          varValue = value;  
       }  
    }  
    

    此代码设置存储和检索 ButtonValue 属性的方法。 get 语句将返回的值设置为存储在私有变量 varValue 中的值,而 set 语句通过使用 value 关键字设置该私有变量的值。

  3. 在“文件”菜单中,选择“全部保存”以保存项目。

测试控件

控件不是独立的项目,它们必须托管在容器中。 若要测试控件,必须提供一个测试项目,以使控件在其中运行。 还必须通过生成(编译)该控件使测试项目能够访问它。 在本节中,将生成控件并在 Windows 窗体中对其进行测试。

生成控件
  1. 在 “生成” 菜单上,单击 “生成解决方案”。

    生成应会成功,且没有任何编译器错误或警告。

创建测试项目
  1. 在“文件”菜单上,指向“添加”,然后单击“新建项目”打开“添加新项目”对话框。

  2. 在“Visual C#”节点下选择“Windows”节点,再单击“Windows 窗体应用程序”。

  3. 在“名称”框中键入 Test。

  4. 在“解决方案资源管理器”中,右键单击测试项目的“引用”节点,然后从快捷菜单上选择“添加引用”以显示“添加引用”对话框。

  5. 单击标记为“项目”的选项卡。 “项目名称”下将列出 ValueButtonLib 项目。 双击该项目将引用添加到测试项目。

  6. 在“解决方案资源管理器”中,右键单击“测试”,然后选择“生成”。

将控件添加到窗体
  1. 在“解决方案资源管理器”中,右键单击“Form1.cs”,然后从快捷菜单中选择“视图设计器”。

  2. 在“工具箱”中单击“ValueButtonLib 组件”。 双击“ValueButton”。

    窗体上将出现“ValueButton”。

  3. 右键单击“ValueButton”,并从快捷菜单中选择“属性”。

  4. 在“属性”窗口中,检查该控件的属性。 请注意,除增加了一个 ButtonValue 属性外,它们与标准按钮公开的属性相同。

  5. 将 ButtonValue 属性设置为 5。

  6. 在所有 Windows 窗体选项卡工具箱,双击标签添加xref:System.Windows.Forms.Label向窗体控件。

  7. 将标签重新定位到窗体的中央。

  8. 双击 valueButton1。

    “代码编辑器”随即打开并显示 valueButton1_Click 事件。

  9. 插入以下代码行。

    label1.Text = valueButton1.ButtonValue.ToString();  
    
  10. 在“解决方案资源管理器”中,右键单击“测试”,然后从快捷菜单中选择“设为启动项目”。

  11. 从“调试”菜单中选择“启动调试”。

    Form1 将出现。

  12. 单击 valueButton1。

    label1 中显示数字“5”,表明继承的控件的 ButtonValue 属性已通过 valueButton1_Click 方法传递给 label1。 这样,ValueButton 控件便继承了标准 Windows 窗体按钮的所有功能,但是公开了一个附加的自定义属性。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。