BlackoutDates Property

Calendar.BlackoutDates Property

.NET Framework (current version)
 

Gets a collection of dates that are marked as not selectable.

Namespace:   System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

member BlackoutDates : CalendarBlackoutDatesCollection with get

Property Value

Type: System.Windows.Controls.CalendarBlackoutDatesCollection

A collection of dates that cannot be selected. The default value is an empty collection.

Dates in this collection will appear gray and crossed out on the calendar.

To make all past dates not selectable, you can use the AddDatesInPast method provided by the collection returned by this property.

<object>
  <object.BlackoutDates>
    oneOrMoreCalendarDateRanges
  </object.BlackoutDates>
</object>

oneOrMoreCalendarDateRanges

One or more object elements of type CalendarDateRange.

The following example creates a Calendar that has some dates that cannot be selected.

No code example is currently available or this language may not be supported.
<!-- Create a Calendar that displays dates through
     Januarary 31, 2009 and has dates that are not selectable. -->
<Calendar Margin="20" SelectionMode="MultipleRange"  
          IsTodayHighlighted="false" 
          DisplayDate="1/1/2009"
          DisplayDateEnd="1/31/2009"
          xmlns:sys="clr-namespace:System;assembly=mscorlib">

  <Calendar.BlackoutDates>
    <CalendarDateRange Start="1/2/2009" End="1/4/2009"/>
    <CalendarDateRange Start="1/9/2009" End="1/9/2009"/>
    <CalendarDateRange Start="1/16/2009" End="1/16/2009"/>
    <CalendarDateRange Start="1/23/2009" End="1/25/2009"/>
    <CalendarDateRange Start="1/30/2009" End="1/30/2009"/>
  </Calendar.BlackoutDates>

  <Calendar.SelectedDates>
    <sys:DateTime>1/5/2009</sys:DateTime>
    <sys:DateTime>1/12/2009</sys:DateTime>
    <sys:DateTime>1/14/2009</sys:DateTime>
    <sys:DateTime>1/13/2009</sys:DateTime>
    <sys:DateTime>1/15/2009</sys:DateTime>
    <sys:DateTime>1/27/2009</sys:DateTime>
    <sys:DateTime>4/2/2009</sys:DateTime>
  </Calendar.SelectedDates>
</Calendar>

The preceding example produces output that is similar to the following illustration.

Calendar with dates that cannot be selected.

Calendar with dates that cannot be selected

.NET Framework
Available since 4.0
Silverlight
Available since 2.0
Return to top
Show:
© 2016 Microsoft