DateRangePicker HtmlHelper Overview

The DateRangePicker HtmlHelper extension is a server-side wrapper for the Kendo UI DateRangePicker widget.

Configuration

Below are listed the steps for you to follow when configuring the Kendo UI DateRangePicker.

  1. Make sure you followed all the steps from the introductory article on Telerik UI for ASP.NET MVC.

  2. Create a new action method which renders the view.

    Example
    public ActionResult Index()
    {
        return View();
    }
    
  3. Add a DateRangePicker.

        <%: Html.Kendo().DateRangePicker()
            .Name("daterangepicker") //The name of the DateRangePicker is mandatory. It specifies the "id" attribute of the widget.
            .Min(new DateTime(1900, 1, 1)) //Set the min date of the DateRangePicker.
            .Max(new DateTime(2099, 12, 31)) //Set the min date of the DateRangePicker.
            .Range(r => r.Start(DateTime.Now).End(DateTime.Now.AddDays(10))) //Set the value of the DateRangePicker.
        %>
    
        @(Html.Kendo().DateRangePicker()
            .Name("daterangepicker") //The name of the DateRangePicker is mandatory. It specifies the "id" attribute of the widget.
            .Min(new DateTime(1900, 1, 1)) //Set the min date of the DateRangePicker.
            .Max(new DateTime(2099, 12, 31)) //Set the min date of the DateRangePicker.
            .Range(r => r.Start(DateTime.Now).End(DateTime.Now.AddDays(10))) //Set the value of the DateRangePicker.
        )
    

Event Handling

You can subscribe to all DateRangePicker events.

By Handler Name

The following example demonstrates how to subscribe to events by a handler name.

Example
    <%: Html.Kendo().DateRangePicker()
        .Name("daterangepicker")
        .Events(e => e
            .Open("daterangepicker_open")
            .Close("daterangepicker_close")
            .Change("daterangepicker_change")
        )
    %>
    <script>
        function daterangepicker_open() {
            //Handle the open event
        }

        function daterangepicker_close() {
            //Handle the close event
        }

        function daterangepicker_change() {
            //Handle the change event
        }
    </script>
    @(Html.Kendo().DateRangePicker()
        .Name("daterangepicker")
        .Events(e => e
            .Open("daterangepicker_open")
            .Close("daterangepicker_close")
            .Change("daterangepicker_change")
        )
    )
    <script>
        function daterangepicker_open() {
            //Handle the open event
        }

        function daterangepicker_close() {
            //Handle the close event
        }

        function daterangepicker_change() {
            //Handle the change event
        }
    </script>

By Template Delegate

The following example demonstrates how to subscribe to events by a template delegate.

Example
    @(Html.Kendo().DateRangePicker()
      .Name("daterangepicker")
      .Events(e => e
          .Open(@<text>
            function() {
                //Handle the open event inline.
            }
          </text>)
          .Change(@<text>
            function() {
                //Handle the change event inline.
            }
            </text>)
      )
    )

Reference

Existing Instances

To reference an existing Kendo UI DateRangePicker instance, use the jQuery.data() method and use the DateRangePicker API to control its behavior.

Example
// Put this after your Kendo UIDateRangePicker for ASP.NET MVC declaration.
<script>
    $(function() {
        // Notice that the Name() of the DateRangePicker is used to get its client-side instance.
        var daterangepicker = $("#daterangepicker").data("kendoDateRangePicker");
    });
</script>

See Also

In this article
Not finding the help you need? Improve this article