CheckBoxList Constructor
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í.
Inicializa una nueva instancia de la clase CheckBoxList.
public:
CheckBoxList();
public CheckBoxList ();
Public Sub New ()
Ejemplos
En el ejemplo de código siguiente se muestra cómo crear e inicializar una nueva instancia del CheckBoxList control.
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#" AutoEventWireup="True" %>
<!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> CheckBoxList Constructor Example </title>
<script runat="server">
void Check_Clicked(Object sender, EventArgs e)
{
// Retrieve the CheckBoxList control from the Controls collection
// of the PlaceHolder control.
CheckBoxList checklist =
(CheckBoxList)Place.FindControl("checkboxlist1");
// Make sure a control was found.
if(checklist != null)
{
Message.Text = "Selected Item(s):<br /><br />";
// Iterate through the Items collection of the CheckBoxList
// control and display the selected items.
for (int i=0; i<checklist.Items.Count; i++)
{
if (checklist.Items[i].Selected)
{
Message.Text += checklist.Items[i].Text + "<br />";
}
}
}
else
{
// Display an error message.
Message.Text = "Unable to find CheckBoxList control.";
}
}
void Page_Load(Object sender, EventArgs e)
{
// Create a new CheckBoxList control.
CheckBoxList checklist = new CheckBoxList();
// Set the properties of the control.
checklist.ID = "checkboxlist1";
checklist.AutoPostBack = true;
checklist.CellPadding = 5;
checklist.CellSpacing = 5;
checklist.RepeatColumns = 2;
checklist.RepeatDirection = RepeatDirection.Vertical;
checklist.RepeatLayout = RepeatLayout.Flow;
checklist.TextAlign = TextAlign.Right;
// Populate the CheckBoxList control.
checklist.Items.Add(new ListItem("Item 1"));
checklist.Items.Add(new ListItem("Item 2"));
checklist.Items.Add(new ListItem("Item 3"));
checklist.Items.Add(new ListItem("Item 4"));
checklist.Items.Add(new ListItem("Item 5"));
checklist.Items.Add(new ListItem("Item 6"));
// Manually register the event-handling method for the
// SelectedIndexChanged event.
checklist.SelectedIndexChanged += new EventHandler(this.Check_Clicked);
// Add the control to the Controls collection of the
// PlaceHolder control.
Place.Controls.Add(checklist);
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> CheckBoxList Constructor Example </h3>
Select items from the CheckBoxList.
<br /><br />
<asp:PlaceHolder id="Place" runat="server"/>
<br /><br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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> CheckBoxList Constructor Example </title>
<script runat="server">
Sub Check_Clicked(sender As Object, e As EventArgs)
' Retrieve the CheckBoxList control from the Controls collection
' of the PlaceHolder control.
Dim checklist As CheckBoxList = _
CType(Place.FindControl("checkboxlist1"), CheckBoxList)
' Make sure a control was found.
If Not checklist Is Nothing
Message.Text = "Selected Item(s):<br /><br />"
' Iterate through the Items collection of CheckBoxList
' control and display the selected items.
Dim i As Integer
For i=0 To checklist.Items.Count - 1
If checklist.Items(i).Selected Then
Message.Text &= checklist.Items(i).Text & "<br />"
End If
Next i
Else
' Display an error message.
Message.Text = "Unable to find CheckBoxList control."
End If
End Sub
Sub Page_Load(sender As Object, e As EventArgs)
' Create a new CheckBoxList control.
Dim checklist As CheckBoxList = New CheckBoxList()
' Set the properties of the control.
checklist.ID = "checkboxlist1"
checklist.AutoPostBack = True
checklist.CellPadding = 5
checklist.CellSpacing = 5
checklist.RepeatColumns = 2
checklist.RepeatDirection = RepeatDirection.Vertical
checklist.RepeatLayout = RepeatLayout.Flow
checklist.TextAlign = TextAlign.Right
' Populate the CheckBoxList control.
checklist.Items.Add(New ListItem("Item 1"))
checklist.Items.Add(New ListItem("Item 2"))
checklist.Items.Add(New ListItem("Item 3"))
checklist.Items.Add(New ListItem("Item 4"))
checklist.Items.Add(New ListItem("Item 5"))
checklist.Items.Add(New ListItem("Item 6"))
' Manually register the event-handling method for the
' SelectedIndexChanged event.
AddHandler checklist.SelectedIndexChanged, AddressOf Check_Clicked
' Add the control to the Controls collection of the
' PlaceHolder control.
Place.Controls.Add(checklist)
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3> CheckBoxList Constructor Example </h3>
Select items from the CheckBoxList.
<br /><br />
<asp:PlaceHolder id="Place" runat="server"/>
<br /><br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
Comentarios
Use este constructor para crear e inicializar una nueva instancia de la CheckBoxList clase .