ListItem.Enabled Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si el elemento de lista está habilitado.
public:
property bool Enabled { bool get(); void set(bool value); };
public bool Enabled { get; set; }
member this.Enabled : bool with get, set
Public Property Enabled As Boolean
Valor de propiedad
Es true
si el elemento de lista está habilitado; en caso contrario, es false
. De manera predeterminada, es true
.
Ejemplos
En el ejemplo siguiente se muestra cómo usar la Enabled propiedad para deshabilitar mediante programación los elementos de lista en un RadioButtonList control . La primera pregunta hace al usuario que seleccione el botón de radio correspondiente a la ocupación del usuario. Si el usuario indica que no son un desarrollador, los elementos de lista de la segunda lista de botones de radio están deshabilitados. La segunda pregunta hace al usuario que seleccione un lenguaje de programación principal. Esta pregunta no es relevante para un usuario que no es un desarrollador.
Nota
En el ejemplo de código siguiente se usa el modelo de código de un solo archivo y es posible que no funcione correctamente si se copia directamente en un archivo de código subyacente. Este ejemplo de código debe copiarse en un archivo de texto vacío que tenga una extensión .aspx. Para obtener más información sobre el modelo de código de formularios Web Forms, consulte ASP.NET modelo de código de página de formularios web forms.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ListItem.Enabled Property Example</title>
<script runat="server">
protected void Index_Changed(object sender, EventArgs e)
{
// if the user is not a developer, do not
// ask the user to select a programming language.
if (RadioButtonList1.SelectedIndex == 2)
{
// Clear any previously selected list
// items in the second question.
RadioButtonList2.SelectedIndex = -1;
// Disable all the list items in the second question.
for (int i = 0; i < RadioButtonList2.Items.Count; i++)
{
RadioButtonList2.Items[i].Enabled = false;
}
}
else
// Enable all the list items in the second question.
for (int i = 0; i < RadioButtonList2.Items.Count; i++)
{
RadioButtonList2.Items[i].Enabled = true;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>ListItem.Enabled Property Example</h3>
Select your occupation:
<asp:radiobuttonlist id="RadioButtonList1"
autopostback="true"
onselectedindexchanged="Index_Changed"
runat="server">
<asp:ListItem>Web developer</asp:ListItem>
<asp:ListItem>Windows developer</asp:ListItem>
<asp:ListItem>Occupation other than developer</asp:ListItem>
</asp:radiobuttonlist>
<br /><br />
Select your primary programming language:
<asp:radiobuttonlist id="RadioButtonList2"
runat="server">
<asp:ListItem>Visual Basic .NET</asp:ListItem>
<asp:ListItem>C#</asp:ListItem>
<asp:ListItem>C++</asp:ListItem>
<asp:ListItem>Other</asp:ListItem>
</asp:radiobuttonlist>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ListItem.Enabled Property Example</title>
<script runat="server">
Sub Index_Changed(ByVal sender As Object, ByVal e As System.EventArgs)
Dim i As Integer
' If the user is not a developer, do not
' ask the user to select a programming language.
If radiobuttonlist1.SelectedIndex = 2 Then
' Clear any previously selected list
' items in the second question.
Radiobuttonlist2.SelectedIndex = -1
' Disable all the list items in the second question.
For i = 0 To Radiobuttonlist2.Items.Count - 1
Radiobuttonlist2.Items(i).Enabled = False
Next
Else
' Enable all the list items in the second question.
For i = 0 To Radiobuttonlist2.Items.Count - 1
Radiobuttonlist2.Items(i).Enabled = True
Next i
End If
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>ListItem.Enabled Property Example</h3>
Select your occupation:
<asp:radiobuttonlist id="RadioButtonList1"
autopostback="true"
onselectedindexchanged="Index_Changed"
runat="server">
<asp:ListItem>Web developer</asp:ListItem>
<asp:ListItem>Windows developer</asp:ListItem>
<asp:ListItem>Occupation other than developer</asp:ListItem>
</asp:radiobuttonlist>
<br /><br />
Select your primary programming language:
<asp:radiobuttonlist id="RadioButtonList2"
runat="server">
<asp:ListItem>Visual Basic .NET</asp:ListItem>
<asp:ListItem>C#</asp:ListItem>
<asp:ListItem>C++</asp:ListItem>
<asp:ListItem>Other</asp:ListItem>
</asp:radiobuttonlist>
</form>
</body>
</html>
Comentarios
La Enabled propiedad permite especificar si un ListItem control está habilitado o deshabilitado. Un ListItem control deshabilitado está atenuado para indicar que no se puede seleccionar. Utilice esta propiedad para deshabilitar un ListItem control en un RadioButtonList control o en un CheckBoxList control .
Nota
No se puede usar esta propiedad para deshabilitar un ListItem control en un DropDownList control o ListBox control.
Se aplica a
Consulte también
- RadioButtonList
- CheckBoxList
- ListControl
- ListBox
- DropDownList
- Información general sobre el control de servidor web ListBox
- Información general sobre controles de servidor web RadioButton y RadioButtonList
- Información general sobre controles de servidor web CheckBox y CheckBoxList
- Información general sobre el control de servidor web BulletedList
- Información general sobre el control de servidor web DropDownList