New to Telerik UI for ASP.NET Core? Start a free 30-day trial

CheckBoxGroup in Razor Pages

Updated on Dec 10, 2025

This article describes how to seamlessly integrate and configure the Telerik UI CheckBoxGroup for ASP.NET Core in Razor Pages applications.

You can use any of the available data binding approaches to bind the component to data in a Razor Pages application.

Referencing Handler Methods in Razor Pages

Razor Pages is an alternative to the MVC pattern that makes page-focused coding easier and more productive. This approach consists of a cshtml file and a cshtml.cs file (by convention, the two files have the same name).

The cshtml.cs file, known as the PageModel, contains handler methods that respond to HTTP requests. These methods are prefixed with On followed by the HTTP verb (for example, OnGet, OnPost, OnPostRead, OnPostCreate).

Handler methods declared in a PageModel can be referenced from any Razor Page using one of the following URL patterns:

Using Url.Page()
C#
```
Url.Page("PageName", "HandlerName")
// OR
Url.Page("/FolderName/PageName", "HandlerName")
```
For example, Url.Page("Index", "Read") references the OnPostRead or OnGetRead handler method in the Index.cshtml.cs file.
Using a query string
C#
```
Url("/PathToPage?handler=HandlerName")
```
For example, Url("/Index?handler=Read") references the OnPostRead or OnGetRead handler method in the Index page.

For more information on Razor Pages architecture and concepts, refer to the official Microsoft documentation.

Binding to Local Data

The following example demonstrates how to bind the CheckBoxGroup component to a local dataset within a Razor Pages application.

Razor
    @page
    @model CheckBoxGroupIndexModel

    @inject Microsoft.AspNetCore.Antiforgery.IAntiforgery Xsrf
    @Html.AntiForgeryToken()

    <label>Select color:</label>
    @(Html.Kendo().CheckBoxGroup()
        .Name("checkboxgroup")
        .BindTo(Model.CheckBoxGroupModel.Items)
        .Value(Model.CheckBoxGroupModel.CheckBoxGroupValue)
    )
Razor
    @page
    @model CheckBoxGroupIndexModel
    
    @inject Microsoft.AspNetCore.Antiforgery.IAntiforgery Xsrf
    @Html.AntiForgeryToken()

    <kendo-checkboxgroup name="checkboxgroup"
        value="@Model.CheckBoxGroupModel.CheckBoxGroupValue"
        bind-to="@Model.CheckBoxGroupModel.Items">
    </kendo-checkboxgroup>
C#
public class CheckBoxGroupIndexModel : PageModel
{
	public List<IInputGroupItem> itemsList { get; set; }

    [BindProperty]
    public CheckBoxGroupViewModel CheckBoxGroupModel { get; set; }

    public void OnGet()
    {
        if (CheckBoxGroupModel == null)
        {
            itemsList = new List<IInputGroupItem>()
            {
                new InputGroupItemModel()
                {
                    Label = "Red",
                    Value = "one"
                },
                    new InputGroupItemModel()
                {
                    Label = "Green",
                    Value = "two"
                },
                    new InputGroupItemModel()
                {
                    Label = "Blue",
                    Value = "three"
                }
            };

            CheckBoxGroupModel = new CheckBoxGroupViewModel() { Items = itemsList, CheckBoxGroupValue = new string[] { "two" } };
        }
    }
}
C#
    public class InputGroupItemModel: IInputGroupItem
    {
        public IDictionary<string, object> HtmlAttributes { get; set; }

        public string CssClass { get; set; }

        public bool? Enabled { get; set; }

        public bool? Encoded { get; set; }

        public string Label { get; set; }

        public string Value { get; set; }
    }
C#
    public class CheckBoxGroupViewModel
    {
        public List<IInputGroupItem> Items { get; set; }
        public string[] CheckBoxGroupValue { get; set; }
    }

For the complete project, refer to the CheckBoxGroup in Razor Pages example.

CheckBoxGroup in Razor Pages

Referencing Handler Methods in Razor Pages

Binding to Local Data

See Also