Элемент управления ASP.NET ListItemControl

Web Server ControlsСерверные элементы управления

Определение и использование

Элемент управления ListItem может создать элемент в списке.

Этот элемент управления используется вместе со следующими элементами управления списками:<asp:ListBox>、 <asp:RadioButtonList>и<asp:BulletedList>。

Синтаксис

<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="label"
Value="value" />

Свойства

Свойства Описание .NET
Атрибуты Необязательно. Коллекция пар имя/значение атрибутов для ListItem, которые не поддерживаются непосредственно этим классом. 1.0
Enabled Необязательно. Указывает, является ли элемент отключенным или включенным. 2.0
Selected Необязательно. Указывает, выбран ли элемент. 1.0
Текст Необязательно. Текст, отображаемый в ListItem. 1.0
Значение Необязательно. Значение ListItem. 1.0

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

AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width

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

Стандартные свойства элемента управления

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible

Для полного описания посетитеСтандартные свойства элемента управления。

Можно использовать свойство Text или Value, а также внутренний HTML-текст, чтобы задать текст, отображаемый для элемента списка.

Примеры

<asp:ListItem Value="Text1" Text="Text2">Text3</asp:ListItem>

В зависимости от комбинации свойства Text или Value и внутреннего HTML-текста может отображаться разный текст и могут использоваться разные значения. В следующей таблице перечислены все возможные комбинации и их результаты:

Внутренний HTML Свойство Text Свойство Value Отображаемый текст Используемое значение
Set Set Set Внутренний HTML Свойство Value
Set Set Не задано Внутренний HTML Внутренний HTML
Set Не задано Set Внутренний HTML Свойство Value
Set Не задано Не задано Внутренний HTML Внутренний HTML
Не задано Set Set Свойство Text Свойство Value
Не задано Set Не задано Свойство Text Свойство Text
Не задано Не задано Set Свойство Value Свойство Value
Не задано Не задано Не задано Не задано Не задано

Советы и примечания

Примечание:Поскольку и свойство Text, и свойство Value имеют пустую строку в качестве значения по умолчанию, элементы управления списками могут содержать пустые элементы списка.

Примеры

BulletedList с базовым ListItem
В этом примере демонстрируется элемент управления BulletedList с двумя элементами ListItem в файле .aspx.

ListBox с элементами ListItem с разными свойствами
В этом примере демонстрируется элемент управления ListBox с несколькими элементами ListItem в файле .aspx. Элементы списка используют разные свойства для отображения текста ListItem.

ListBox с отключённым ListItem
В этом примере показан элемент управления ListBox с отключённым ListItem.

RadioButtonList с выбранным ListItem
В этом примере показан элемент управления RadioButtonList с выбранным ListItem.

Web Server ControlsВеб-серверные элементы управления Другие расширения