DateRangePicker HtmlHelper Overview

The Telerik UI DateRangePicker HtmlHelper for ASP.NET MVC is a server-side wrapper for the Kendo UI DateRangePicker widget.

The DateRangePicker is a container for holding start and end date inputs.

Basic Configuration

  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.

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

        <%: Html.Kendo().DateRangePicker()
            .Name("daterangepicker") // The name of the DateRangePicker is mandatory. It specifies the "id" attribute of the DateRangePicker.
            .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 DateRangePicker.
            .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.
        )
    

Events

You can subscribe to all DateRangePicker events. For a complete example on basic DateRangePicker events, refer to the demo on using the events of the DateRangePicker.

Handling by Handler Name

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

    <%: 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>

Handling by Template Delegate

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

    @(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>)
      )
    )

Referencing Existing Instances

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

// Place the following after theDateRangePicker for ASP.NET MVC declaration.
<script>
    $(function() {
        // 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