基本 Web 服务器控件属性

更新:2007 年 11 月

下表列出的属性适用于所有从 WebControl 类派生的 Web 服务器控件。不从 WebControl 类继承的 Web 服务器控件包括 LiteralPlaceHolderRepeaterXml

属性

AccessKey

控件的键盘快捷键 (AccessKey)。此属性指定用户在按住 Alt 的同时可以按下的单个字母或数字。例如,如果希望用户按下 Alt+K 以访问控件,则指定“K”。仅在 Microsoft Internet Explorer 4.0 及其更高版本中支持快捷键。

Attributes

控件上的未由公共属性定义但仍需呈现的附加属性集合。任何未由 Web 服务器控件定义的属性都添加到此集合中。这使您可以使用未被控件直接支持的 HTML 属性。

说明:

只能在编程时使用此属性;不能在声明控件时设置此属性。

BackColor

控件的背景色。BackColor 属性可以使用标准的 HTML 颜色标识符来设置:颜色名称(“black”或“red”)或者以十六进制格式(“#ffffff”)表示的 RGB 值。

BorderColor

控件的边框颜色。BorderColor 属性可以使用标准的 HTML 颜色标识符来设置:颜色名称(“black”或“red”)或者以十六进制格式(“#ffffff”)表示的 RGB 值。

BorderWidth

控件边框(如果有的话)的宽度(以像素为单位)。

说明:

此属性可能不适用于 Internet Explorer 4.0 之前的浏览器中的所有控件。

BorderStyle

控件的边框样式(如果有的话)。可能的值包括:

  • NotSet

  • None

  • Dotted

  • Dashed

  • Solid

  • Double

  • Groove

  • Ridge

  • Inset

  • Outset

CssClass

分配给控件的级联样式表 (CSS) 类。

Style

作为控件的外部标记上的 CSS 样式属性呈现的文本属性集合。

说明:

任何使用样式属性(例如 BackColor)设置的样式值都将自动重写此集合中的对应值。使用此属性设置的值不会自动反映在强类型样式属性中。

某些控件支持允许您将样式属性应用于控件的各个元素的样式对象。这些属性将重写使用 Style 属性进行的任何设置。

Enabled

当此属性设置为 true(默认值)时使控件起作用。当此属性设置为 false 时禁用控件。

说明:

禁用控件将使该控件变灰并使之处于非活动状态。它并不会隐藏控件。

EnableTheming

当此属性设置为 true(默认值)时对控件启用视图状态持久性。当此属性设置为 false 时对该控件禁用视图状态持久性。

EnableViewState

当此属性设置为 true(默认值)时对控件启用主题。当此属性设置为 false 时对该控件禁用主题。

Font

为正在声明的 Web 服务器控件提供字体信息。此属性包含子属性,您可以在 Web 服务器控件元素的开始标记中使用属性-子属性语法来声明这些子属性。例如,可以通过在 Web 服务器控件文本的开始标记中包含 Font-Bold 属性而使该文本以粗体显示。

ForeColor

控件的前景色。

说明:

此属性可能不适用于 Internet Explorer 4.0 之前的浏览器中的所有控件。

Height

控件的高度。

说明:

此属性可能不适用于 Internet Explorer 4.0 之前的浏览器中的所有控件。

SkinID

要应用于控件的外观。

TabIndex

控件的位置(按 Tab 键顺序)。如果未设置此属性,则控件的位置索引为 0。具有相同选项卡索引的控件可以按照它们在网页中的声明顺序用 Tab 键导航。

说明:

此属性只适用于 Internet Explorer 4.0 及更高版本。

ToolTip

当用户将鼠标指针定位在控件上方时显示的文本。

说明:

ToolTip 属性并不适用于所有浏览器。请检查浏览器的兼容性。

Width

控件的固定宽度。可能的单位包括:

  • 像素 (px)

  • 磅 (pt)

  • 派卡 (pc)

  • 英寸 (in)

  • 毫米 (mm)

  • 厘米 (cm)

  • 百分比 (%)

  • 大写字母 M 的宽度 (em)

  • 小写字母 x 的高度 (ex)

例如,以声明方式设置 100 磅宽就是 100pt。有关以编程方式设置宽度的信息,请参见如何:设置 Web 服务器控件的单位属性

说明:

默认单位是像素。并非所有浏览器都支持每种单位类型。

请参见

参考

System.Web.UI.WebControls

其他资源

Web 服务器控件语法