CalendarBlackoutDatesCollection 类

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

表示 Calendar 中的非可选日期的集合。

public ref class CalendarBlackoutDatesCollection sealed : System::Collections::ObjectModel::ObservableCollection<System::Windows::Controls::CalendarDateRange ^>

public sealed class CalendarBlackoutDatesCollection : System.Collections.ObjectModel.ObservableCollection<System.Windows.Controls.CalendarDateRange>

type CalendarBlackoutDatesCollection = class
    inherit ObservableCollection<CalendarDateRange>

Public NotInheritable Class CalendarBlackoutDatesCollection
Inherits ObservableCollection(Of CalendarDateRange)

继承

Object

Collection<T>

ObservableCollection<CalendarDateRange>

CalendarBlackoutDatesCollection

示例

以下示例在代码和标记中创建一个 Calendar ，其中包含一些无法选择的日期。

  // Create a Calendar that displays dates through
  // Januarary 31, 2009 and has dates that are not selectable.
  Calendar calendarWithBlackoutDates = new Calendar();
  calendarWithBlackoutDates.IsTodayHighlighted = false;
  calendarWithBlackoutDates.DisplayDate = new DateTime(2009, 1, 1);
  calendarWithBlackoutDates.DisplayDateEnd = new DateTime(2009, 1, 31);
  calendarWithBlackoutDates.SelectionMode = CalendarSelectionMode.MultipleRange;

  // Add the dates that are not selectable.
  calendarWithBlackoutDates.BlackoutDates.Add(
      new CalendarDateRange(new DateTime(2009, 1, 2), new DateTime(2009, 1, 4)));
  calendarWithBlackoutDates.BlackoutDates.Add(
      new CalendarDateRange(new DateTime(2009, 1, 9)));
  calendarWithBlackoutDates.BlackoutDates.Add(
      new CalendarDateRange(new DateTime(2009, 1, 16)));
  calendarWithBlackoutDates.BlackoutDates.Add(
      new CalendarDateRange(new DateTime(2009, 1, 23), new DateTime(2009, 1, 25)));
  calendarWithBlackoutDates.BlackoutDates.Add(
      new CalendarDateRange(new DateTime(2009, 1, 30)));

  // Add the selected dates.
  calendarWithBlackoutDates.SelectedDates.Add(
      new DateTime(2009, 1, 5));
  calendarWithBlackoutDates.SelectedDates.AddRange(
      new DateTime(2009, 1, 12), new DateTime(2009, 1, 15));
  calendarWithBlackoutDates.SelectedDates.Add(
      new DateTime(2009, 1, 27));

  // root is a Panel that is defined elswhere.
  root.Children.Add(calendarWithBlackoutDates);

' Create a Calendar that displays dates through 
' Januarary 31, 2009 and has dates that are not selectable. 
Dim calendarWithBlackoutDates As New Calendar()
calendarWithBlackoutDates.IsTodayHighlighted = False
calendarWithBlackoutDates.DisplayDate = New DateTime(2009, 1, 1)
calendarWithBlackoutDates.DisplayDateEnd = New DateTime(2009, 1, 31)
calendarWithBlackoutDates.SelectionMode = CalendarSelectionMode.MultipleRange

' Add the dates that are not selectable. 
calendarWithBlackoutDates.BlackoutDates.Add(New CalendarDateRange(New DateTime(2009, 1, 2), New DateTime(2009, 1, 4)))
calendarWithBlackoutDates.BlackoutDates.Add(New CalendarDateRange(New DateTime(2009, 1, 9)))
calendarWithBlackoutDates.BlackoutDates.Add(New CalendarDateRange(New DateTime(2009, 1, 16)))
calendarWithBlackoutDates.BlackoutDates.Add(New CalendarDateRange(New DateTime(2009, 1, 23), New DateTime(2009, 1, 25)))
calendarWithBlackoutDates.BlackoutDates.Add(New CalendarDateRange(New DateTime(2009, 1, 30)))

' Add the selected dates. 
calendarWithBlackoutDates.SelectedDates.Add(New DateTime(2009, 1, 5))
calendarWithBlackoutDates.SelectedDates.AddRange(New DateTime(2009, 1, 12), New DateTime(2009, 1, 15))
calendarWithBlackoutDates.SelectedDates.Add(New DateTime(2009, 1, 27))

' root is a Panel that is defined elswhere. 
root.Children.Add(calendarWithBlackoutDates)

<!-- 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>

前面的示例生成类似于下图的输出。

无法选择日期的日历

注解

CalendarBlackoutDatesCollection包含CalendarDateRange指定用户无法选择的多个日期的对象。 若要使过去的所有日期不可选择，可以使用 AddDatesInPast 方法。

XAML 属性元素用法

<object>  
  <object.property>  
    oneOrMoreCalendarDateRanges  
  </object.property>  
</object>  

XAML 值

oneOrMoreCalendarDateRanges
类型的 CalendarDateRange一个或多个对象元素。

构造函数

CalendarBlackoutDatesCollection(Calendar)

初始化 CalendarBlackoutDatesCollection 类的新实例。

属性

Count	获取 Collection<T> 中实际包含的元素数。 (继承自 Collection<T>)
Item[Int32]	获取或设置指定索引处的元素。 (继承自 Collection<T>)
Items	获取 IList<T> 周围的 Collection<T> 包装。 (继承自 Collection<T>)

方法

Add(T)	将对象添加到 Collection<T> 的结尾处。 (继承自 Collection<T>)
AddDatesInPast()	向集合中添加 Today 之前的所有日期。
BlockReentrancy()	不允许可重入的更改此集合的尝试。 (继承自 ObservableCollection<T>)
CheckReentrancy()	检查企图更改此集合的可重入尝试。 (继承自 ObservableCollection<T>)
Clear()	从 Collection<T> 中移除所有元素。 (继承自 Collection<T>)
ClearItems()	从集合中移除所有项。 (继承自 ObservableCollection<T>)
Contains(DateTime)	返回一个值，该值表示此集合是否包含指定的日期。
Contains(DateTime, DateTime)	返回一个值，该值表示此集合是否包含指定的日期范围。
Contains(T)	确定某元素是否在 Collection<T> 中。 (继承自 Collection<T>)
ContainsAny(CalendarDateRange)	返回一个值，该值表示此集合是否包含指定日期范围中的任何日期。
CopyTo(T[], Int32)	从目标数组的指定索引处开始将整个 Collection<T> 复制到兼容的一维 Array。 (继承自 Collection<T>)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	返回循环访问 Collection<T> 的枚举数。 (继承自 Collection<T>)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(T)	搜索指定的对象，并返回整个 Collection<T> 中第一个匹配项的从零开始的索引。 (继承自 Collection<T>)
Insert(Int32, T)	将元素插入 Collection<T> 的指定索引处。 (继承自 Collection<T>)
InsertItem(Int32, T)	将一项插入集合中指定索引处。 (继承自 ObservableCollection<T>)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Move(Int32, Int32)	将指定索引处的项移至集合中的新位置。 (继承自 ObservableCollection<T>)
MoveItem(Int32, Int32)	将指定索引处的项移至集合中的新位置。 (继承自 ObservableCollection<T>)
OnCollectionChanged(NotifyCollectionChangedEventArgs)	通过提供的参数引发 CollectionChanged 事件。 (继承自 ObservableCollection<T>)
OnPropertyChanged(PropertyChangedEventArgs)	通过提供的参数引发 PropertyChanged 事件。 (继承自 ObservableCollection<T>)
Remove(T)	从 Collection<T> 中移除特定对象的第一个匹配项。 (继承自 Collection<T>)
RemoveAt(Int32)	移除 Collection<T> 的指定索引处的元素。 (继承自 Collection<T>)
RemoveItem(Int32)	删除集合内指定索引处的项。 (继承自 ObservableCollection<T>)
SetItem(Int32, T)	替换指定索引处的元素。 (继承自 ObservableCollection<T>)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

CollectionChanged	在添加、删除或移动项或刷新整个列表时发生。 (继承自 ObservableCollection<T>)
PropertyChanged	在属性值更改时发生。 (继承自 ObservableCollection<T>)

扩展方法