属性
|
示例
|
BindableAttribute
设计时属性。
指定将数据绑定到属性是否有意义。在可视化设计器中,属性浏览器可以在对话框中显示控件的可绑定属性。(例如,在 Visual Studio 中,可绑定属性显示在“数据绑定”对话框中。) 如果属性 (Property) 没有使用此属性 (Attribute) 标记,则属性 (Property) 浏览器会推断其值为 Bindable(false)。
|
[Bindable(true)]
应用于演练:开发和使用自定义服务器控件中的 WelcomeLabel 示例控件的 Text 属性。
|
BrowsableAttribute
设计时属性。
指定是否应在可视化设计器的属性浏览器中显示某个属性。 将 Browsable(false) 应用于不希望在属性浏览器中显示的属性。没有通过此属性 (Attribute) 标记某个属性 (Property) 时,属性浏览器会推断其默认值为 Browsable(true)。
|
[Browsable(false)]
应用于模板化服务器控件示例中的 VacationHome 示例控件中的 Template 属性。
|
CategoryAttribute
设计时属性。
指定如何在可视化设计器的属性浏览器中对属性进行分类。例如,当页开发人员在属性浏览器中使用分类视图时,Category("Appearance") 将告知属性浏览器在“外观”类别中显示属性。可以指定一个对应于属性浏览器中的现有类别的字符串参数,也可以创建自己的类别。
|
[Category("Appearance")]
应用于演练:开发和使用自定义服务器控件中的 WelcomeLabel 示例控件的 Text 属性
|
DefaultValueAttribute
设计时属性。
指定属性的默认值。此值应与从属性访问器 (getter) 返回的默认值相同。在有些可视化设计器(如 Visual Studio)中,DefaultValueAttribute 属性允许页开发人员使用快捷菜单上的“重置”命令将属性值重置为其默认值。
|
[DefaultValue("")]
应用于演练:开发和使用自定义服务器控件中的 WelcomeLabel 示例控件的 Text 属性
|
DescriptionAttribute
设计时属性。
指定属性的简短描述。在可视化设计器(如 Visual Studio)中,属性浏览器通常在窗口底部显示选定的属性的描述。
|
[Description("The welcome message text.")]
应用于演练:开发和使用自定义服务器控件中的 WelcomeLabel 示例控件的 Text 属性
|
DesignerSerializationVisibilityAttribute
设计时属性。
指定是否对设计时设置的属性或其内容(如子属性或集合项)进行序列化。该属性的构造函数的参数是一个 DesignerSerializationVisibility 枚举值。未应用此属性 (Attribute) 且属性 (Property) 的值已序列化时,则暗示使用默认值 Visible。
|
[DesignerSerializationVisibility
(DesignerSerializationVisibility.Content)]
应用于服务器控件属性示例中的 Book 示例控件的 Author 属性。
|
EditorAttribute
设计时属性。
将自定义 UITypeEditor 编辑器与某个属性或属性类型关联。如果已将此属性 (Attribute) 应用于该类型,则不必将其应用于该类型的属性 (Property)。
|
[Editor(typeof(ContactCollectionEditor), typeof(UITypeEditor))]
应用于 Web 控件集合属性示例中的 QuickContacts 示例控件的 Contacts 属性。
|
EditorBrowsableAttribute
设计时属性。
指定属性名称是否显示在源编辑器的 IntelliSense 列表中。也可将此属性应用于方法和事件。此属性的构造函数的参数是一个 EditorBrowsableState 枚举值。未应用此属性时,则暗示使用默认值 Always。
|
[EditorBrowsableAttribute
(EditorBrowsableState.Never)]
应用前面示例中演示的属性,以隐藏 IntelliSense 中的成员。
|
FilterableAttribute
设计时和分析时属性。
指定某个属性是否能参与设备和浏览器筛选。页开发人员利用筛选能在一个控件声明中为不同的浏览器指定不同的属性值。例如,页开发人员可以使用筛选为 Label 控件的 Text 属性设置不同的值,其语法如下所示:
<asp:Label UP:Text="Hello" and IE:Text="Welcome to my site" runat="server" />
“UP”和“IE”是浏览器筛选器。未应用此属性时,则暗示使用默认值 Filterable(true)。
|
[Filterable(false)]
应用前面示例中演示的属性 (Attribute) 以从设备和浏览器筛选中排除某个属性 (Property)。
|
LocalizableAttribute
设计时属性。
指定对属性进行本地化是否有意义。如果一个属性标记为 Localizable(true),则对应的属性值存储在资源文件中。未应用此属性时,则暗示使用默认值 Localizable(false)。
|
[Localizable(true)]
应用于演练:开发和使用自定义服务器控件中的 WelcomeLabel 示例控件的 Text 属性。
|
NotifyParentPropertyAttribute
设计时属性。
指定在属性浏览器中对子属性所做的更改应传播到父属性。
|
[NotifyParentProperty(true)]
应用于服务器控件属性示例中定义的 Author 类型的 FirstName、LastName 和 MiddleName 属性。
|
PersistenceModeAttribute
设计时属性。
指定是将属性 (Property) 保存为控件标记上的属性 (Attribute),还是将其保存为控件标记中的嵌套内容。此属性的构造函数的参数是一个 PersistenceMode 枚举值。
|
[PersistenceMode(PersistenceMode.InnerProperty)]
应用于服务器控件属性示例中的 Book 示例控件的 Author 属性。
|
TemplateContainerAttribute
设计时和分析时属性。
为返回 ITemplate 接口的属性指定命名容器类型。
|
[TemplateContainer(typeof(CustomTemplateContainer))]
应用上一示例中所示的属性 (Attribute) 以指定 ITemplate 属性 (Property) 由 CustomTemplateContainer 类表示。
|
TemplateInstanceAttribute
设计时和分析时属性。
指定模板属性允许创建单个实例还是多个实例。如果未使用 TemplateInstanceAttribute 属性 (Attribute) 扩展模板属性 (Property),则默认情况下允许创建多个实例。
|
[TemplateInstance(TemplateInstance.Single)]
应用上一示例中所示的属性 (Attribute) 以指定只能创建一个模板属性 (Property) 实例。
|
ThemeableAttribute
分析时属性。
指定控件成员是否可以受主题或控件外观的影响。默认情况下,如果控件类型本身可应用主题,则该控件公开的所有属性都可以应用主题。
|
[Themeable(false)]
应用上一示例中所示的属性以防止控件成员受主题或控件外观的影响。
|
TypeConverterAttribute
设计时、分析时和运行时属性。
将类型转换器与某个属性或属性类型关联。类型转换器执行从字符串表示形式到指定类型(或相反)的转换。
|
[TypeConverter(typeof(AuthorConverter))]
应用于服务器控件属性示例中定义的 Author 类型。
|
UrlPropertyAttribute
设计时和运行时属性。
指定一个字符串属性表示一个 URL 值,利用此值可以将 URL 生成器与该属性关联起来。
|
[UrlProperty("*.aspx",AllowedTypes=UrlTypes.Absolute|UrlTypes.RootRelative|UrlTypes.AppRelative)]
应用于为 ASP.NET 文件设置特定的文件筛选器,并且允许绝对路径和相对路径。
|
请发表评论