Captcha in Razor Pages
This article describes how to seamlessly integrate and configure the Telerik UI Captcha 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 theOnPostReadorOnGetReadhandler method in theIndex.cshtml.csfile. -
Using a query string
C#Url("/PathToPage?handler=HandlerName")For example,
Url("/Index?handler=Read")references theOnPostReadorOnGetReadhandler method in theIndexpage.
For more information on Razor Pages architecture and concepts, refer to the official Microsoft documentation.
Getting Started
To set up the Captcha for a Razor Pages scenario, you need to configure the server-side handler methods that will validate the user's input. The URL in these methods must refer to the name of the PageModel. From there, to further configure your application's backend, refer to the Validation article.
@page
@model CaptchaIndexModel
@inject Microsoft.AspNetCore.Antiforgery.IAntiforgery Xsrf
@{
var token = Xsrf.GetAndStoreTokens(HttpContext).RequestToken;
}
@(Html.Kendo().Form<OrderViewModel>()
.Name("formExample")
.FormData(Model.Order)
.HtmlAttributes(new { method = "POST" })
.Validatable(v =>
{
v.ValidateOnBlur(true);
v.ValidationSummary(true);
v.ErrorTemplate("<span style='color: red'>#:message#</span>");
})
.Items(items =>
{
items.AddAntiForgeryToken(Html.AntiForgeryToken());
items.Add()
.Field(f => f.ShipName)
.Label(l => l.Text("Ship Name:"))
.Hint("Hint: Ship Name must be at least 5 characters long to pass server validation rules");
items.Add()
.Field(f => f.ShipCity)
.Label(l => l.Text("Ship City"));
items.Add()
.Field(f => f.OrderDate)
.Editor(e => e.DatePicker())
.Label(l => l.Text("Order Date:"));
items.Add()
.Field(f => f.Freight)
.Editor(e => e.NumericTextBox())
.Label(l => l.Text("Freight:"));
items.Add()
.Field("Captcha")
.Editor(ed => ed.Captcha()
.CaptchaImage((string)ViewData["Captcha"])
.CaptchaId((string)ViewData["CaptchaID"])
.DataCaptchaField("Captcha")
.DataCaptchaIdField("CaptchaID")
.Handler(handler => handler.Url(Url.Page("CaptchaIndex", "Reset")))
.AudioHandlerFunction("audioHandler")
.ValidationHandler(handler => handler.Url(Url.Page("CaptchaIndex", "Validate")))
);
})
)For the complete project, refer to the Captcha in Razor Pages example.