基 Web 服务器控件属性

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

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

属性

AccessKey

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

Attributes

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

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

BackColor

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

BorderColor

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

BorderWidth

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

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

BorderStyle

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

  • NotSet

  • None

  • Dotted

  • Dashed

  • Solid

  • Double

  • Groove

  • Ridge

  • Inset

  • Outset

CssClass

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

Style

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

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

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

Enabled

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

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

EnableTheming

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

EnableViewState

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

Font

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

ForeColor

控件的前景色。

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

Height

控件的高度。

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

SkinID

要应用于控件的外观。

TabIndex

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

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

ToolTip

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

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

Width

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

  • 像素 (px)

  • 磅 (pt)

  • 派卡 (pc)

  • 英寸 (in)

  • 毫米 (mm)

  • 厘米 (cm)

  • 百分比 (%)

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

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

例如,以声明方式设置 100 磅宽就是 100pt。 有关以编程方式设置宽度的信息,请参见How to: Set Web Server Control Unit Properties

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

请参见

参考

System.Web.UI.WebControls

其他资源

Web 服务器控件语法