# TimeDurationPicker in Razor Pages

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

## 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](https://learn.microsoft.com/en-us/aspnet/core/razor-pages/).

## Binding to a PageModel Property

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

1. Add a property to the `PageModel` that must bind to the TimeDurationPicker.

   ```csharp Index.cshtml.cs
   public class IndexModel : PageModel
   {
       [BindProperty]
       public decimal? Duration { get; set; }

       public void OnGet()
       {
           // Assign a value in milliseconds (1h 30m = 5400000 ms)
           Duration = 5400000m;
       }

       public void OnPost()
       {
           // Duration will be populated with the submitted value
       }
   }
   ```

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

   ```Razor
   @page
   @model IndexModel
   ```

3. Bind the TimeDurationPicker to the property using the `TimeDurationPickerFor()` configuration.

   ```Razor HtmlHelper
   @page
   @model IndexModel

   @(Html.Kendo().TimeDurationPickerFor(m => m.Duration)
         .InputMode("numeric")
         .Columns(c =>
         {
             c.Hours().Format("## hours ");
             c.Minutes().Format(" ## minutes");
         })
   )
   ```

   ```Razor TagHelper
   @page
   @model IndexModel
   @addTagHelper *, Kendo.Mvc

   <kendo-timedurationpicker for="Duration" input-mode="numeric">
       <timedurationpicker-columns>
           <timedurationpicker-column name="hours" format="## hours "></timedurationpicker-column>
           <timedurationpicker-column name="minutes" format=" ## minutes"></timedurationpicker-column>
       </timedurationpicker-columns>
   </kendo-timedurationpicker>
   ```

## Notes

* The recommended binding type is `decimal?`.
* The unit of the value is milliseconds.
* Validation attributes such as `[BindProperty]` and data annotations like `[Required]` are supported.
* Use the `InputMode()` and `Columns()` configuration (or their TagHelper equivalents) to explicitly define how the duration values are displayed.

## See Also

* [Using Telerik UI for ASP.NET Core in Razor Pages](https://docs.telerik.com/aspnet-core/getting-started/razor-pages#using-telerik-ui-for-aspnet-core-in-razor-pages)
* [Client-Side API of the TimeDurationPicker](https://www.telerik.com/kendo-jquery-ui/documentation/api/ui/timedurationpicker)
* [Server-Side HtmlHelper API of the TimeDurationPicker](https://www.telerik.com/aspnet-core-ui/documentation/api/timedurationpicker)
* [Server-Side TagHelper API of the TimeDurationPicker](https://www.telerik.com/aspnet-core-ui/documentation/api/taghelpers/timedurationpicker)
* [Knowledge Base Section](https://www.telerik.com/aspnet-core-ui/documentation/knowledge-base)
