Edit this page

Server-side Data Binding Overview

The article shows how to set up RadCheckBoxList with data binding.

RadCheckBoxList can use the standard data sources for binding an ASP.NET control:

  • Declarative ASP.NET data sources (SqlDatasource, ObjectDataSource, LinqDataSource, etc.)
  • Server-side collections that implement the IEnumerable interface.

Server-side Data Binding Basics

RadCheckBoxList exposes the Databindings composite property to configure the fields needed for data binding:

  • DataTextField binds the Text property of the items with the corresponding field.
  • DataValueField binds the Value property of the items with the corresponding field.
  • DataSelectedField binds the Selected property of the items with the corresponding field.
  • DataEnabledField binds the Enabled property of the items with the corresponding field.

Example 1: Data binding RadCheckBoxList with a collection in the code behind.

<telerik:RadCheckBoxList runat="server" ID="RadCheckBoxList1">
    <Databindings DataTextField="Text" DataValueField="Value" 
        DataSelectedField="Selected" DataEnabledField="Enabled" />
</telerik:RadCheckBoxList>
protected void Page_Load(object sender, EventArgs e)
{
    if (!Page.IsPostBack)
    {
        RadCheckBoxList1.DataSource = GetData();
        RadCheckBoxList1.DataBind();
    }
}

private IEnumerable<object> GetData()
{
    List<object> result = new List<object>() {
        new { Text = "English", Value = "en",
                Selected = true, Enabled = true },
        new { Text = "German", Value = "de",
                Selected = false, Enabled = true },
        new { Text = "french", Value = "fr",
                Selected = false, Enabled = true }
    };

    return result;
}
Protected Sub Page_Load(sender As Object, e As EventArgs)
    If Not Page.IsPostBack Then
        RadCheckBoxList1.DataSource = GetData()
        RadCheckBoxList1.DataBind()
    End If
End Sub

Private Function GetData() As IEnumerable(Of Object)
    Dim result As New List(Of Object)() From { _
        New With { _
            Key .Text = "English", _
            Key .Value = "en", _
            Key .Selected = True, _
            Key .Enabled = True _
        }, _
        New With { _
            Key .Text = "German", _
            Key .Value = "de", _
            Key .Selected = False, _
            Key .Enabled = True _
        }, _
        New With { _
            Key .Text = "french", _
            Key .Value = "fr", _
            Key .Selected = False, _
            Key .Enabled = True _
        } _
    }

    Return result
End Function

See Also