Поделиться через

Основные свойства серверного веб-элемента управления

  • Статья

Свойства, перечисленные в приведенной ниже таблице, применимы ко всем серверным веб-элементам управления, являющимся производными от класса WebControl. К серверным веб-элементам управления, не наследующим от класса WebControl, относятся элементы Literal, PlaceHolder, Repeater и Xml.

Свойства

AccessKey

Клавиша быстрого вызова данного элемента управления (AccessKey). Это свойство задает одну букву или цифру, которую пользователь может нажать, удерживая нажатой клавишу ALT. Например, укажите букву "K", если для обращения к этому элементу управления пользователь должен нажать ALT+K. Клавиши быстрого вызова поддерживаются только в Microsoft Internet Explorer 4.0 и более поздних версиях.

Attributes

Коллекция дополнительных атрибутов элемента управления, которые не определяются открытым свойством, но также должны воспроизводиться. В эту коллекцию добавляется любой атрибут, не определенный серверным веб-элементом управления. Благодаря этому возможно использование HTML-атрибута, не поддерживаемого непосредственно элементом управления.

ПримечаниеПримечание
Данное свойство применяется только при программировании и не может быть установлено при объявлении элемента управления.

BackColor

Цвет фона элемента управления. Для установки свойства BackColor можно использовать стандартные идентификаторы цвета HTML — имя цвета ("black" или "red") либо значение RGB, выраженное шестнадцатеричном формате ("#ffffff").

BorderColor

Цвет рамки элемента управления. Для установки свойства BorderColor можно использовать стандартные идентификаторы цвета HTML — имя цвета ("black" или "red") либо значение RGB, выраженное шестнадцатеричном формате ("#ffffff").

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

Предоставляет сведения о шрифтах для объявляемого серверного веб-элемента управления. У этого свойства имеются подчиненные свойства, которые можно объявлять с помощью синтаксиса "свойство-подчиненное свойство" в открывающем теге серверного веб-элемента управления. Например, чтобы текст в серверном веб-элементе управления отображался полужирным шрифтом, необходимо включить атрибут Font-Bold в его открывающий тег.

ForeColor

Основной цвет элемента управления.

ПримечаниеПримечание
Данное свойство работает не для всех элементов управления в обозревателях, предшествующих Internet Explorer 4.0.

Height

Высота элемента управления.

ПримечаниеПримечание
Данное свойство работает не для всех элементов управления в обозревателях, предшествующих Internet Explorer 4.0.

SkinID

Обложка, применяемая к элементу управления.

TabIndex

Положение элемента управления в порядке перехода по клавише табуляции. Если это свойство не задано, индекс положения элемента управления имеет значение 0. Перемещение между элементами управления с одинаковым индексом табуляции происходит с соответствии с порядком их объявления на веб-странице.

ПримечаниеПримечание
Это свойство работает только в Microsoft Internet Explorer 4.0 и более поздних версиях.

ToolTip

Текст, появляющийся при наведении указателя мыши на элемент управления.

ПримечаниеПримечание
Свойство ToolTip работает не во всех обозревателях.Следует проверить обозреватель на совместимость.

Width

Фиксированная ширина элемента управления. Допустимые единицы измерения:

  • Точка (px)

  • Пункт (pt)

  • Пика (pc)

  • Дюйм (in)

  • Миллиметр (mm)

  • Сантиметр (cm)

  • Процент (%)

  • Максимальный пробел (em)

  • Экс (ex)

Например, декларативная установка ширины, равной 100 и выраженной в пунктах, выглядит как 100pt. Сведения о программной установке ширины см. в разделе Практическое руководство. Настройка свойств единиц измерения серверного веб-элемента управления.

ПримечаниеПримечание
Единицами измерения по умолчанию являются точки.Некоторые обозреватели поддерживают не все типы единиц измерения.

См. также

Ссылки

System.Web.UI.WebControls

Другие ресурсы

Синтаксис серверного веб-элемента управления