ASPxDateEdit.CalendarCustomDisabledDate Event

Allows you to disable days in the editor’s calendar.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

public event EventHandler<CalendarCustomDisabledDateEventArgs> CalendarCustomDisabledDate

VB.NET

Public Event CalendarCustomDisabledDate As EventHandler(Of CalendarCustomDisabledDateEventArgs)

Event Data

The CalendarCustomDisabledDate event's data class is CalendarCustomDisabledDateEventArgs. The following properties provide information specific to this event:

Property	Description
Date	Gets the currently processed date.
IsDisabled	Specifies whether the processed date is disabled for selection.

Remarks

The editor raises the CalendarCustomDisabledDate event each time the editor needs to rerender a day cell.

Additionally, you can use the ASPxClientDateEdit.CalendarCustomDisabledDate event to disable dates on the client side. The ASPxDateEdit.DisabledDates property allows you to specify a collection of disabled dates in the calendar.

Note

The CustomDisabledDate event handlers affect the manner in which the calendar is updated (navigates to another month/year).

• When only the client-side ASPxClientDateEdit.CalendarCustomDisabledDate event is handled, the calendar operates on the client side.
• When only the server-side CalendarCustomDisabledDate event is handled, the manner in which the calendar is updated depends upon the ASPxEdit.AutoPostBack property setting. If the ASPxEdit.AutoPostBack property is set to true, the calendar initiates a postback to the server; otherwise, it’s updated using callback technology.
• When both events are handled, the calendar operates on the client side. However, for the calendar to work properly, you should provide equivalent logic in both the client and server-side event handlers.

Tip

We recommend that you use the CalendarCustomDisabledDate event to customize the editor appearance (disabled days) only. If you disable days, handle the Validation event to ensure that users do not enter disabled dates in the editor input.

Example

ASPX

<dx:ASPxDateEdit ID="dateEdit" runat="server" EditFormat="Custom" Date="2009-11-02 09:23" 
OnCalendarCustomDisabledDate="dateEdit_CalendarCustomDisabledDate">
    <TimeSectionProperties>
        <TimeEditProperties EditFormatString="hh:mm tt" />
    </TimeSectionProperties>
    <CalendarProperties>
        <FastNavProperties DisplayMode="Inline" />
    </CalendarProperties>
</dx:ASPxDateEdit>

C#

protected void dateEdit_CalendarCustomDisabledDate(object sender, DevExpress.Web.CalendarCustomDisabledDateEventArgs e)
{
    if (e.Date.DayOfWeek == DayOfWeek.Wednesday)
        e.IsDisabled = true;
}

Result: