New to Telerik UI for ASP.NET Core? Start a free 30-day trial

Chat in Razor Pages

Updated on Dec 10, 2025

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

You can use any of the available data binding approaches to bind the component to data in a Razor Pages application.

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.

Binding to Remote Data

To connect the Chat to a data set retrieved from a remote endpoint in a Razor Pages application, proceed with the following steps:

Specify the Read, Create, and Update options of the DataSource configuration. The URL in each of these options must refer to the method name in the PageModel.

Razor
@page
@model IndexModel

@(Html.Kendo().Chat()
    .Name("chat")
    .Height("600px")
    .Width("400px")
    .AuthorId("1")
    .TextField("Text")
    .AuthorNameField("AuthorName")
    .FilesField("Files")
    .AuthorIdField("AuthorId")
    .AuthorImageUrlField("AuthorImageUrl")
    .AuthorImageAltTextField("AuthorImageAltText")
    .TimestampField("TimeStamp")
    .IdField("Id")
    .IsPinnedField("IsPinned")
    .IsDeletedField("IsDeleted")
    .IsTypingField("IsTyping")
    .DataSource(dataSource => dataSource
        .Ajax()
        .Read(r => r.Url(Url.Page("Index", "ReadMessages")).Data("forgeryToken"))
        .Create(r => r.Url(Url.Page("Index", "CreateMessage")).Data("forgeryToken"))
        .Update(r => r.Url(Url.Page("Index", "UpdateMessage")).Data("forgeryToken"))
    )
    .Events(events => events.SendMessage("onSendMessage"))
)
Razor
@page
@model IndexModel

<kendo-chat name="chat"
    height="600"
    width="400"
    author-id="1"
    text-field="Text"
    author-name-field="AuthorName"
    files-field="Files"
    author-id-field="AuthorId"
    author-image-url-field="AuthorImageUrl"
    author-image-alt-text-field="AuthorImageAltText"
    timestamp-field="TimeStamp"
    id-field="Id"
    is-pinned-field="IsPinned"
    is-deleted-field="IsDeleted"
    is-typing-field="IsTyping"
    on-send-message="onSendMessage">
    <datasource type="DataSourceTagHelperType.Ajax">
        <transport>
            <read url="@Url.Page("Index", "ReadMessages")" data="forgeryToken"/>
            <create url="@Url.Page("Index", "CreateMessage")" data="forgeryToken" />
            <update url="@Url.Page("Index", "UpdateMessage")" data="forgeryToken" />
        </transport>
    </datasource>
</kendo-chat>
JS
<script>
    function onSendMessage(e) {
        const currentUser = {
            id: 1,
            name: "John Doe",
            iconUrl: "https://demos.telerik.com/aspnet-core/shared/web/Customers/RICSU.jpg",
            iconAltText: "John's profile picture"
        };

        e.message.authorId = currentUser.id;
        e.message.authorName = currentUser.name;
        e.message.authorImageUrl = currentUser.iconUrl;
        e.message.authorImageAltText = currentUser.iconAltText;

        setTimeout(() => {
            e.sender.scrollToBottom();
        }, 30);
    }
</script>

Add an AntiForgeryToken at the top of the page.

Razor

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

Send the AntiForgeryToken with the Read request.

JavaScript

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

Additional parameters can also be supplied.

JavaScript

    <script>
        function forgeryToken() {
            return {
                __RequestVerificationToken: kendo.antiForgeryTokens().__RequestVerificationToken,
                additionalParameter: "test"
            }
        }
    </script>

Within the cshtml.cs file, add a handler method for each data operation.

public class IndexModel : PageModel
{
    public static List<ChatMessage> messages;

    public void OnGet(string culture)
    {
        if (!String.IsNullOrEmpty(culture))
        {
            CultureInfo.DefaultThreadCurrentCulture = CultureInfo.DefaultThreadCurrentUICulture = new CultureInfo(culture);
        }

        if (messages == null)
        {
            messages = GetData();
        }
    }

    public JsonResult OnPostReadMessages()
    {
        var dsResult = new DataSourceResult
        {
            Data = messages.Select(message => new
            {
                message.Id,
                message.AuthorId,
                message.AuthorName,
                message.AuthorImageUrl,
                message.AuthorImageAltText,
                message.Text,
                message.TimeStamp,
                message.IsDeleted,
                message.IsPinned,
                message.IsTyping,
                Files = message.Files.Select(file => new
                {
                    extension = file.Extension,
                    size = file.Size,
                    type = file.Type,
                    name = file.Name
                })
            })
        };
        return new JsonResult(dsResult);
    }

    public JsonResult OnPostCreateMessage([DataSourceRequest] DataSourceRequest request, ChatMessage message)
    {
        message.Id = Guid.NewGuid().ToString();
        // Set the Message ID explicitly and perform a custom create operation to the database.
        var messageObject = new {
            Id = message.Id,
            AuthorId = message.AuthorId,
            AuthorName = message.AuthorName,
            AuthorImageUrl = message.AuthorImageUrl,
            AuthorImageAltText = message.AuthorImageAltText,
            Text = message.Text,
            TimeStamp = message.TimeStamp,
            IsDeleted = message.IsDeleted,
            IsPinned = message.IsPinned,
            IsTyping = message.IsTyping,
            Files = message.Files?.Select(file => new
            {
                extension = file.Extension,
                size = file.Size,
                type = file.Type,
                name = file.Name
            }).ToList() ?? []
        };
        return new JsonResult(new[] { messageObject }.ToDataSourceResult(request));
    }

    public JsonResult OnPostUpdateMessage([DataSourceRequest] DataSourceRequest request, ChatMessage message)
    {
        // Perform a custom update operation to the existing database.
        var messageObject = new {
            Id = message.Id,
            AuthorId = message.AuthorId,
            AuthorName = message.AuthorName,
            AuthorImageUrl = message.AuthorImageUrl,
            AuthorImageAltText = message.AuthorImageAltText,
            Text = message.Text,
            TimeStamp = message.TimeStamp,
            IsDeleted = message.IsDeleted,
            IsPinned = message.IsPinned,
            IsTyping = message.IsTyping,
            Files = message.Files?.Select(file => new
            {
                extension = file.Extension,
                size = file.Size,
                type = file.Type,
                name = file.Name
            }).ToList() ?? []
        };
        return new JsonResult(new[] { messageObject }.ToDataSourceResult(request));
    }

    private static List<ChatMessage> GetData()
    {
        return new List<ChatMessage>()
        {
             new ChatMessage {
                 Id = "1",
                 AuthorId = "1",
                 AuthorName = "Lora",
                 AuthorImageUrl = "https://demos.telerik.com/aspnet-core/shared/web/Customers/ANATR.jpg",
                 AuthorImageAltText = "Lora's profile picture",
                 Text = "Hey Emma! I just booked my trip to Japan for next month! I'm so excited but also a bit nervous since it's my first time there. Any tips?",
                 TimeStamp = new DateTime(2025, 7, 20),
                 IsPinned = true,
                 IsTyping = false,
                 IsDeleted = false
             },
             new ChatMessage {
                 Id = "2",
                 AuthorId = "2",
                 AuthorName = "Emma",
                 AuthorImageUrl = "https://demos.telerik.com/aspnet-core/shared/web/Customers/DUMON.jpg",
                 AuthorImageAltText = "Emma's profile picture",
                 Text = "Don't miss the cherry blossoms if they're still blooming! And try the street food in Osaka - it's the best!",
                 TimeStamp = new DateTime(2025, 7, 20),
                 IsPinned = false,
                 IsTyping = false,
                 IsDeleted = false
             },
             new ChatMessage {
                 Id = "3",
                 AuthorId = "1",
                 AuthorName = "Lora",
                 AuthorImageUrl = "https://demos.telerik.com/aspnet-core/shared/web/Customers/ANATR.jpg",
                 AuthorImageAltText = "Lora's profile picture",
                 Text = "Perfect! I'm definitely going during cherry blossom season. Should I book accommodations in advance, or can I find places as I go?",
                 TimeStamp = new DateTime(2025, 7, 20),
                 IsPinned = false,
                 IsTyping = false,
                 IsDeleted = false
             },
             new ChatMessage
             {
                 Id = "4",
                 AuthorId = "2",
                 AuthorName = "Emma",
                 AuthorImageUrl = "https://demos.telerik.com/aspnet-core/shared/web/Customers/DUMON.jpg",
                 AuthorImageAltText = "Emma's profile picture",
                 Text = "Definitely book in advance, especially during cherry blossom season! It gets super busy. I recommend staying in a ryokan in Kyoto for the traditional experience. Here you will find the schedule we used when we were there.",
                 TimeStamp = new DateTime(2025, 7, 20),
                 IsPinned = false,
                 IsTyping = false,
                 IsDeleted = false,
                 Files = new List<ChatFile>
                 {
                     new ChatFile
                     {
                         Name = "Sightseeing_schedule.pdf",
                         Size = 245760,
                         Extension = "pdf",
                         Type = "application/pdf"
                     },
                     new ChatFile
                     {
                         Name = "Favourite_place.jpg",
                         Size = 156000,
                         Extension = "jpg",
                         Type = "image/jpeg"
                     }
                 }
             },
             new ChatMessage
             {
                 Id = "5",
                 AuthorId = "1",
                 AuthorName = "Lora",
                 AuthorImageUrl = "https://demos.telerik.com/aspnet-core/shared/web/Customers/ANATR.jpg",
                 AuthorImageAltText = "Lora's profile picture",
                 Text = "Thanks for all the advice, Emma. I'll definitely send you photos!",
                 TimeStamp = new DateTime(2025, 7, 20),
                 IsPinned = false,
                 IsTyping = false,
                 IsDeleted = false
             }
        };
    }
}

Chat in Razor Pages

Referencing Handler Methods in Razor Pages

Binding to Remote Data

See Also