How to: Customize Status and Label Properties

• Feb 16, 2026
• 3 minutes to read

This topic describes how to define custom statuses and labels for your Scheduler events in XAF ASP.NET Core Blazor or Windows Forms applications.

Note

For this article, you can use the MainDemo application installed as part of the XAF package. The default location of the application is %PUBLIC%\Documents\DevExpress Demos 25.2\Components\XAF.

The instructions below explain how to define the following custom items:

• “Vacation” and “Personal” labels
• “Free” and “Out of Office” statuses

ASP.NET Core Blazor

XAF stores source data for labels and status items in a DxSchedulerDataStorage object. Use the OnSchedulerDataStorageCreated event to customize this object’s settings. Specified values will be available for Label and Status properties of the built-in Event object (or your custom IEvent implementation).

1. In the Solution Explorer , navigate to the MainDemo.Blazor.Server\Startup.cs file and make the following changes to the AddScheduler(IModuleBuilder<IBlazorApplicationBuilder>, Action<SchedulerOptions>) method:

2. Build the project and run the application. The Event Detail View displays new labels and status items:

Windows Forms

XAF stores source data for labels and status items in a SchedulerStorage object. Use Appointments property to access Labels and Statuses collections.

1. In the MainDemo.Win.Controllers folder, create a WinSchedulerController class. Replace the generated class declaration with the code sample below:

2. Build the project and run the application. The Event Detail View displays new labels and status items: