ASP.NET ListItemControl

Web Server ControlsControles de servidor Web

Definición y uso

El control ListItem puede crear un elemento en una lista.

Este control se utiliza junto con los siguientes controles de lista:<asp:ListBox>、 <asp:RadioButtonList>y<asp:BulletedList>。

Sintaxis

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

Propiedades

Propiedades Descripción .NET
Attributes Opcional. Colección de pares de nombre y valor de atributos de ListItem que esta clase no admite directamente. 1.0
Enabled Opcional. Especifica si el elemento está deshabilitado o habilitado. 2.0
Selected Opcional. Especifica si el elemento está seleccionado. 1.0
Text Opcional. El texto que se muestra en ListItem. 1.0
Value Opcional. El valor de ListItem. 1.0

Propiedades estándar de controles Web

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

Para obtener una descripción completa, visitePropiedades estándar de controles Web。

Propiedades estándar del control

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

Para obtener una descripción completa, visitePropiedades estándar del control。

Es posible utilizar la propiedad Text o Value, así como el texto HTML interno, para configurar el texto que se muestra en el elemento de lista.

Ejemplo

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

Según la combinación de las propiedades Text o Value y el texto HTML interno, se puede mostrar texto diferente y se pueden utilizar valores diferentes. La siguiente tabla enumera todas las combinaciones posibles y sus resultados:

Inner HTML Propiedad Text Propiedad Value Texto mostrado Valor utilizado
Establecido Establecido Establecido Inner HTML Propiedad Value
Establecido Establecido No establecido Inner HTML Inner HTML
Establecido No establecido Establecido Inner HTML Propiedad Value
Establecido No establecido No establecido Inner HTML Inner HTML
No establecido Establecido Establecido Propiedad Text Propiedad Value
No establecido Establecido No establecido Propiedad Text Propiedad Text
No establecido No establecido Establecido Propiedad Value Propiedad Value
No establecido No establecido No establecido No establecido No establecido

Consejos y notas

Nota:Dado que las propiedades Text y Value tienen valores predeterminados de cadena vacía, es posible que haya elementos de lista vacíos en el control de lista.

Ejemplo

BulletedList con ListItem básico
Este ejemplo muestra un control BulletedList con dos ListItem en un archivo .aspx.

ListBox con ListItem con diferentes propiedades
Este ejemplo muestra un control ListBox con varios ListItem en un archivo .aspx. Los elementos de la lista utilizan diferentes propiedades para mostrar el texto del ListItem.

ListBox con ListItem deshabilitado
Este ejemplo muestra un control ListBox con un ListItem deshabilitado.

RadioButtonList con ListItem seleccionado
Este ejemplo muestra un control RadioButtonList con un ListItem seleccionado.

Web Server ControlsControles de servidor Web Otras extensiones