演练:向用户控件添加简单属性

更新:2007 年 11 月

本演练演示如何向设备项目中的用户控件添加属性。具体地说,添加使控件属性 (property) 在设计时可见的自定义属性 (attribute)。您可能希望在项目中添加此功能以防止属性值被更改。

该过程与桌面过程相似,不同之处在于设备项目将此信息存储在单独的元数据文件 (.xmta) 中。

说明:

对于在以下说明中使用的某些 Visual Studio 用户界面元素,您的计算机可能会显示不同的名称或位置。这些元素取决于您使用的 Visual Studio 版本及设置。有关更多信息,请参见Visual Studio 设置

本演练是使用“Visual C# 开发设置”编写的。

创建 UserControl1 类

  1. 在“文件”菜单上指向“新建”,然后单击“项目”。

  2. 在“项目类型”窗格中,展开“Visual C#”,然后单击“智能设备”。

  3. 在“模板”窗格中单击“智能设备项目”。

  4. 在“名称”框中,键入“MyControlLibrary”,然后单击“确定”。

  5. 在“添加新智能设备项目”对话框中,从“目标平台”下拉列表中选择“Pocket PC 2003”,从“.NET Compact Framework”下拉列表中选择“.NET Compact Framework 2.0 版”,单击“模板”窗格中的“控件库”,再单击“确定”。

    设计器将打开,并显示一个表示新建用户控件类的正方形。

添加属性

  1. 在“解决方案资源管理器”中,右击“UserControl1.cs”,再单击“查看类关系图”。

    将打开一个表示类关系图的圆角矩形。

  2. 右击该类关系图,再单击“类详细信息”。

  3. 在“类详细信息”窗口的“属性”部分中,在“<添加属性>”提示下,键入“MyProperty”。

  4. 在“类型”列中,用“string”替换“int”。

  5. 右击 MyProperty 行开头的图标,再单击“属性”。

  6. 若要指定“自定义属性”属性的值,请单击省略号按钮 (…) 以打开“自定义属性”对话框。

  7. 键入 Browsable(false),然后单击“确定”。

    “解决方案资源管理器”将显示包含该自定义属性的设计时属性 .xmta 文件(“DesignTimeAttributes.xmta”)。

生成控件库

  1. 在“解决方案资源管理器”中右击“UserControl1.cs”,再单击“查看代码”。

  2. 注释掉引发 System.NotImplementedException 的行,改为插入 return ""; 作为 get 操作。

  3. 在“生成”菜单上单击“生成 MyControlLibrary”。

测试 MyProperty 是否未显示在属性浏览器中

  1. 在“解决方案资源管理器”中右击“MyControlLibrary”,指向“添加”,再单击“新建项”。

  2. 在“添加新项”对话框中,单击“类别”窗格中的“Windows 窗体”,再单击“模板”窗格中的“Windows 窗体”,然后单击“添加”。

  3. 将“UserControl1”从“工具箱”拖到窗体上。

  4. 右击窗体上的用户控件图像,再单击“属性”。

    “MyProperty”未显示在“属性”浏览器中。

  5. 在“解决方案资源管理器”中,双击该 .xmta 文件,然后将“false”替换为“true”。

  6. 重复这些步骤,以查看“属性”网格。注意,“MyProperty”现在显示出来。

请参见

参考

Visual Basic 和 Visual C#(如何实现 - 智能设备)