演练：向用户控件添加简单属性
更新：2007 年 11 月
本演练演示如何向设备项目中的用户控件添加属性。具体地说，添加使控件属性 (property) 在设计时可见的自定义属性 (attribute)。您可能希望在项目中添加此功能以防止属性值被更改。
该过程与桌面过程相似，不同之处在于设备项目将此信息存储在单独的元数据文件 (.xmta) 中。
.gif "说明") 说明： |
|---|
对于在以下说明中使用的某些 Visual Studio 用户界面元素，您的计算机可能会显示不同的名称或位置。这些元素取决于您使用的 Visual Studio 版本及设置。有关更多信息，请参见Visual Studio 设置。 |
本演练是使用“Visual C# 开发设置”编写的。
创建 UserControl1 类
在“文件”菜单上指向“新建”，然后单击“项目”。
在“项目类型”窗格中，展开“Visual C#”，然后单击“智能设备”。
在“模板”窗格中单击“智能设备项目”。
在“名称”框中，键入“MyControlLibrary”，然后单击“确定”。
在“添加新智能设备项目”对话框中，从“目标平台”下拉列表中选择“Pocket PC 2003”，从“.NET Compact Framework”下拉列表中选择“.NET Compact Framework 2.0 版”，单击“模板”窗格中的“控件库”，再单击“确定”。
设计器将打开，并显示一个表示新建用户控件类的正方形。
添加属性
在“解决方案资源管理器”中，右击“UserControl1.cs”，再单击“查看类关系图”。
将打开一个表示类关系图的圆角矩形。
右击该类关系图，再单击“类详细信息”。
在“类详细信息”窗口的“属性”部分中，在“<添加属性>”提示下，键入“MyProperty”。
在“类型”列中，用“string”替换“int”。
右击 MyProperty 行开头的图标，再单击“属性”。
若要指定“自定义属性”属性的值，请单击省略号按钮 (…) 以打开“自定义属性”对话框。
键入 Browsable(false)，然后单击“确定”。
“解决方案资源管理器”将显示包含该自定义属性的设计时属性 .xmta 文件（“DesignTimeAttributes.xmta”）。
生成控件库
在“解决方案资源管理器”中右击“UserControl1.cs”，再单击“查看代码”。
注释掉引发 System.NotImplementedException 的行，改为插入 return ""; 作为 get 操作。
在“生成”菜单上单击“生成 MyControlLibrary”。
测试 MyProperty 是否未显示在属性浏览器中
在“解决方案资源管理器”中右击“MyControlLibrary”，指向“添加”，再单击“新建项”。
在“添加新项”对话框中，单击“类别”窗格中的“Windows 窗体”，再单击“模板”窗格中的“Windows 窗体”，然后单击“添加”。
将“UserControl1”从“工具箱”拖到窗体上。
右击窗体上的用户控件图像，再单击“属性”。
“MyProperty”未显示在“属性”浏览器中。
在“解决方案资源管理器”中，双击该 .xmta 文件，然后将“false”替换为“true”。
重复这些步骤，以查看“属性”网格。注意，“MyProperty”现在显示出来。