MultiColumnComboBox 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 design, the two files have the same name).

You can seamlessly integrate the Telerik UI MultiColumnComboBox for ASP.NET Core in Razor Pages applications.

This article describes how to configure the MultiColumnComboBox component in a Razor Pages scenario.

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

In order to set up the MultiColumnComboBox component bindings, you need to configure the Read method of its DataSource instance. The URL in this method should refer the name of the method in the PageModel. In this method, you can also pass additional parameters, such as filter string and antiforgery token (see dataFunction).

Razor

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

	<h1>MultiColumnComboBox Index</h1>

	@(Html.Kendo().MultiColumnComboBox()
        .Name("products")
        .DataTextField("ShipName")
        .DataValueField("ShipCity")
        .Filter(FilterType.Contains)
        .Columns(columns =>
            {
                columns.Add().Field("ShipName").Title("Ship Name").Width("200px");
                columns.Add().Field("ShipCity").Title("Ship City").Width("200px");
                columns.Add().Field("Freight").Title("Freight").Width("200px");
            })
        .DataSource(ds => ds
            .Custom()
            .Transport(transport => transport
                .Read(r => r
                    .Url("/MultiColumnComboBox/MultiColumnComboBoxIndex?handler=Read").Data("dataFunction")
                ))
                .ServerFiltering(true)
            )
        )
	<script>
		function dataFunction(e) {
			var filterValue = '';
			if (e.filter.filters[0]) {
				filterValue = e.filter.filters[0].value;
			}
			return {
				__RequestVerificationToken: kendo.antiForgeryTokens().__RequestVerificationToken,
				filterValue: filterValue
			};
		}
	</script>

Razor

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

	<h1>MultiColumnComboBox Index</h1>

    <kendo-multicolumncombobox name="products" datatextfield="ShipName" datavaluefield="ShipCity" filter="FilterType.Contains">
        <multicolumncombobox-columns>
            <column field="ShipName" title="Ship Name" width="200px">
            </column>
            <column field="ShipCity" title="Ship City" width="200px">
            </column>
            <column field="Freight" title="Freight" width="200px">
            </column>
        </multicolumncombobox-columns>
        <datasource type="DataSourceTagHelperType.Custom" server-filtering="true">
                <transport>
                    <read url="@Url.Page("/MultiColumnComboBox/MultiColumnComboBoxIndex?handler=Read")" data="dataFunction" />
                </transport>
        </datasource>
    </kendo-multicolumncombobox>

    <script>
		function dataFunction(e) {
			var filterValue = '';
			if (e.filter.filters[0]) {
				filterValue = e.filter.filters[0].value;
			}
			return {
				__RequestVerificationToken: kendo.antiForgeryTokens().__RequestVerificationToken,
				filterValue: filterValue
			};
		}
	</script>

C#

    public JsonResult OnGetRead(string filterValue)
    {
        if (filterValue != null)
        {
            var filteredData = orders.Where(p => p.ShipName.Contains(filterValue));
            return new JsonResult(filteredData);
        }
        return new JsonResult(orders);
    }

Binding the MultiColumnComboBox to a PageModel Property

To bind the MultiColumnComboBox to a property from the PageModel, follow the next steps:

1. Add a property to the PageModel that must bind to the MultiColumnComboBox.

   C#

       public class IndexModel : PageModel
       {
           [BindProperty]
           public int OrderID { get; set; }
   
           public void OnGet()
           {
               OrderID = 2; // Assign a value to the "OrderID" property, if needed.
           }
   
           public JsonResult OnGetRead()
           {
               var comboBoxData = new List<OrderViewModel>();
               // Populate the collection with the ComboBox data.
               return new JsonResult(comboBoxData);
           }
       }

2. Declare the PageModel at the top of the page.

   Razor

       @page
       @model IndexModel

3. Bind the MultiColumnComboBox to the property using the MultiColumnComboBoxFor() configuration.

   Razor

       @page
       @model IndexModel
   
       @inject Microsoft.AspNetCore.Antiforgery.IAntiforgery Xsrf
       @Html.AntiForgeryToken()
       
       @(Html.Kendo().MultiColumnComboBoxFor(m => m.OrderID)  
           .DataTextField("ShipName")
           .DataValueField("OrderID")
           .DataSource(source =>
           {
               source.Read(read => read
                   .Url("/Index?handler=Read").Data("forgeryToken"));
           })
       )

   Razor

       @page
       @model IndexModel
   
       @inject Microsoft.AspNetCore.Antiforgery.IAntiforgery Xsrf
       @Html.AntiForgeryToken()
       @addTagHelper *, Kendo.Mvc
   
       <kendo-multicolumncombobox for="OrderID"
           datatextfield="ShipName" 
           datavaluefield="OrderID">
           <datasource>
               <transport>
                   <read url="/Index?handler=Read" data="forgeryToken"/>
               </transport>
           </datasource>
       </kendo-multicolumncombobox>

   JS

       <script>
           function forgeryToken(e) {
               return kendo.antiForgeryTokens();
           }
       </script>

See Also

• Using Telerik UI for ASP.NET Core in Razor Pages
• Client-Side API of the MultiColumnComboBox
• Server-Side HtmlHelper API of the MultiColumnComboBox
• Server-Side TagHelper API of the MultiColumnComboBox
• Knowledge Base Section