SelectedDatesCollection 类

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

表示 Calendar 中一组选中的日期。

public ref class SelectedDatesCollection sealed : System::Collections::ObjectModel::ObservableCollection<DateTime>

public sealed class SelectedDatesCollection : System.Collections.ObjectModel.ObservableCollection<DateTime>

type SelectedDatesCollection = class
    inherit ObservableCollection<DateTime>

Public NotInheritable Class SelectedDatesCollection
Inherits ObservableCollection(Of DateTime)

继承

Object

Collection<T>

ObservableCollection<DateTime>

SelectedDatesCollection

示例

以下示例创建一个 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>

注解

可以将日期添加到 SelectedDates 的 Calendar属性中。 根据 属性的值 Calendar.SelectionMode ，向 添加日期或范围 SelectedDatesCollection 可能会导致它被清除。 下表列出了对 CalendarSelectionMode 属性的影响 SelectedDates 。

CalendarSelectionMode	对 SelectedDates 的影响
None	不允许选定内容。 SelectedDate 无法设置，并且无法将值添加到 SelectedDates。
SingleDate	只能通过设置 SelectedDate 或 中的 SelectedDates第一个值来选择单个日期。 无法使用 AddRange。
SingleRange	只能选择一个日期范围。 设置 SelectedDate，将日期单独添加到 SelectedDates，或使用 AddRange 将清除 中的所有以前的值。SelectedDates
MultipleRange	可以选择多个非连续范围的日期。 单独向 SelectedDates 或使用 AddRange 添加日期不会清除 SelectedDates。 设置 SelectedDate 仍将清除 SelectedDates，但随后可以添加其他日期或范围。 添加包含某些已选择或与其他范围重叠的日期的区域会导致范围并集，并且不会导致异常。

构造函数

SelectedDatesCollection(Calendar)

初始化 SelectedDatesCollection 类的新实例。

属性

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

方法

Add(T)	将对象添加到 Collection<T> 的结尾处。 (继承自 Collection<T>)
AddRange(DateTime, DateTime)	将指定范围中的所有日期（包括第一个日期和最后一个日期）添加到集合中。
BlockReentrancy()	不允许可重入的更改此集合的尝试。 (继承自 ObservableCollection<T>)
CheckReentrancy()	检查企图更改此集合的可重入尝试。 (继承自 ObservableCollection<T>)
Clear()	从 Collection<T> 中移除所有元素。 (继承自 Collection<T>)
ClearItems()	从集合中移除所有项。 (继承自 ObservableCollection<T>)
Contains(T)	确定某元素是否在 Collection<T> 中。 (继承自 Collection<T>)
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>)

扩展方法