Getting Started with the Telerik WebForms CheckBoxList

The following help article demonstrates how to set up a page with a RadCheckBoxList control and use its OnSelectedIndexChanged server event:

1. In the default page of a new ASP.NET AJAX-enabled Web Application, add a RadCheckBoxList control:

   ASP.NET

    <telerik:RadCheckBoxList ID="RadCheckBoxList1" runat="server">
    </telerik:RadCheckBoxList>

2. Add two ButtonListItem objects to the Items collection and set the appropriate values for Text and Selected properties of each item:

   ASP.NET

    <telerik:RadCheckBoxList ID="RadCheckBoxList1" runat="server">
    	<Items>
    		<telerik:ButtonListItem Text="Accept" Value="0" Selected="true" />
    		<telerik:ButtonListItem Text="Decline" Value="1" />
    	</Items>
    </telerik:RadCheckBoxList>

3. To hook to the OnSelectedIndexChanged server-side event of RadCheckBoxList, add an attribute to the main control tag and add the method signature:

   ASP.NET

    <telerik:RadCheckBoxList ID="RadCheckBoxList1" runat="server" OnSelectedIndexChanged="RadCheckBoxList1_SelectedIndexChanged">
    	<Items>
    		<telerik:ButtonListItem Text="Accept" Value="0" Selected="true" />
    		<telerik:ButtonListItem Text="Decline" Value="1" />
    	</Items>
    </telerik:RadCheckBoxList>

   C#

    protected void RadCheckBoxList1_SelectedIndexChanged(object sender, EventArgs e)
    {
   
    }

   VB.NET

    Protected Sub RadCheckBoxList1_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
    End Sub

4. Add a Label control to write the information to:

   ASP.NET

    <asp:Label ID="Label1" Text="" runat="server" />

5. Use the OnSelectedIndexChanged event handler to write information about the properties of the SelectedItem of the RadCheckBoxList:

   C#

    protected void RadCheckBoxList1_SelectedIndexChanged(object sender, EventArgs e)
    {
    	RadCheckBoxList checkboxlist = sender as RadCheckBoxList;
   
   
    	string data = string.Format("selected index: {0}, selected value {1}, selected text: {2}",
    								checkboxlist.SelectedIndex, checkboxlist.SelectedValue, checkboxlist.SelectedItem.Text);
    	Label1.Text = data;
    }

   VB.NET

    Protected Sub RadCheckBoxList1_SelectedIndexChanged(sender As Object, e As EventArgs)
    	Dim checkboxlist As RadCheckBoxList = TryCast(sender, RadCheckBoxList)
   
   
    	Dim data As String = String.Format("selected index: {0}, selected value {1}, selected text: {2}", checkboxlist.SelectedIndex, checkboxlist.SelectedValue, checkboxlist.SelectedItem.Text)
    	Label1.Text = data
    End Sub

See Also

• Design Time

• Properties and Events