Calendar.SelectedDates Calendar.SelectedDates Calendar.SelectedDates Calendar.SelectedDates Property

Definition

Ruft eine Auflistung ausgewählter Datumsangaben ab.Gets a collection of selected dates.

public:
 property System::Windows::Controls::SelectedDatesCollection ^ SelectedDates { System::Windows::Controls::SelectedDatesCollection ^ get(); };
public System.Windows.Controls.SelectedDatesCollection SelectedDates { get; }
member this.SelectedDates : System.Windows.Controls.SelectedDatesCollection
Public ReadOnly Property SelectedDates As SelectedDatesCollection

Eigenschaftswert

Ein SelectedDatesCollection-Objekt, das die derzeit ausgewählten Datumsangaben enthält.A SelectedDatesCollection object that contains the currently selected dates. Der Standard ist eine leere Auflistung.The default is an empty collection.

Beispiele

Im folgenden Beispiel wird eine Calendar erstellt, die mehrere Datumsbereiche ausgewählt hat.The following example creates a Calendar that has multiple ranges of dates selected.

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

Hinweise

Datumsangaben können der Auflistung entweder einzeln oder in einem Bereich mithilfe der AddRange -Methode hinzugefügt werden.Dates can be added to the collection either individually or in a range using the AddRange method. Abhängig vom Wert SelectionMode der-Eigenschaft kann das Hinzufügen eines Datums oder Bereichs zur Auflistung dazu führen, dass es gelöscht wird.Depending on the value of the SelectionMode property, adding a date or range to the collection may cause it to be cleared. In der folgenden Tabelle ist CalendarSelectionMode aufgeführt, SelectedDates wie die-Eigenschaft beeinflusst.The following table lists how CalendarSelectionMode affects the SelectedDates property.

CalendarSelectionModeCalendarSelectionMode BeschreibungDescription
None Auswahlen sind nicht zulässig.No selections are allowed. SelectedDatekann nicht festgelegt werden, SelectedDatesund es können keine Werte hinzugefügt werden.SelectedDate cannot be set and no values can be added to SelectedDates.
SingleDate Es kann nur ein einzelnes Datum ausgewählt werden, indem entweder SelectedDate oder der erste Wert in SelectedDatesfestgelegt wird.Only a single date can be selected, either by setting SelectedDate or the first value in SelectedDates. AddRangekann nicht verwendet werden.AddRange cannot be used.
SingleRange Ein einzelner Datumsbereich kann ausgewählt werden.A single range of dates can be selected. Durch SelectedDatedas Festlegen eines Datums, das SelectedDateseinzeln zu oder AddRange verwendet wird, werden alle vorherigen SelectedDatesWerte aus gelöscht.Setting SelectedDate, adding a date individually to SelectedDates, or using AddRange will clear all previous values from SelectedDates.
MultipleRange Mehrere nicht zusammenhängende Datumsbereiche können ausgewählt werden.Multiple non-contiguous ranges of dates can be selected. Das Hinzufügen eines Datums SelectedDates , das AddRange einzeln oder verwendet SelectedDateswird, wird nicht gelöscht.Adding a date individually to SelectedDates or using AddRange will not clear SelectedDates. Die SelectedDate Einstellung wird SelectedDatesweiterhin gelöscht, es können jedoch zusätzliche Datumsangaben oder Bereiche hinzugefügt werden.Setting SelectedDate will still clear SelectedDates, but additional dates or ranges can then be added. Wenn Sie einen Bereich hinzufügen, der einige Datumsangaben enthält, die bereits ausgewählt sind oder sich mit einem anderen Bereich überlappen, wird die Gesamtmenge der Bereiche erzielt und keine Ausnahme ausgelöst.Adding a range that includes some dates that are already selected or overlaps with another range results in the union of the ranges and does not cause an exception.

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

<object>  
  <object.SelectedDates>  
    oneOrMoreDateTimeObjects  
  </object.SelectedDates>  
</object>  

XAML-WerteXAML Values

oneOrMoreDateTimeObjectsoneOrMoreDateTimeObjects
Ein oder mehrere DateTime Objekt Elemente.One or more DateTime object elements.

Gilt für: