MonthCalendar.SetSelectionRange(DateTime, DateTime) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Legt die ausgewählten Datumsangaben in einem Monatskalender-Steuerelement auf den angegebenen Datumsbereich fest.

public:
 void SetSelectionRange(DateTime date1, DateTime date2);
public void SetSelectionRange (DateTime date1, DateTime date2);
member this.SetSelectionRange : DateTime * DateTime -> unit
Public Sub SetSelectionRange (date1 As DateTime, date2 As DateTime)

Parameter

date1
DateTime

Das Anfangsdatum des Auswahlbereichs.

date2
DateTime

Das Enddatum des Auswahlbereichs.

Ausnahmen

ArgumentOutOfRangeException

date1 ist kleiner als das kleinste zulässige Datum für ein Monatskalender-Steuerelement.

- oder - date1 ist größer als das größte zulässige Datum für ein Monatskalender-Steuerelement.

- oder - date2 ist kleiner als das kleinste zulässige Datum für ein Monatskalender-Steuerelement.

- oder - date2 ist größer als das größte zulässige Datum für ein Monatskalender-Steuerelement.

Diese Ausnahme wird nur ausgelöst, wenn MinDate oder MaxDate explizit festgelegt wurde.

Hinweise

Die Verwendung dieser Methode entspricht funktionell dem Festlegen der SelectionRange Eigenschaft. Sie können die Anfangs- und Endtermine separat festlegen, indem Sie entweder die Eigenschaft oder SelectionEnd die SelectionStart Eigenschaft festlegen.

Wenn Sie den Parameter größer als den date1 date2 Parameter festlegen, werden beide Datumswerte auf den date1 Wert festgelegt.

Hinweis

Durch scrollen durch die Kalenderanzeige mit den Navigationsschaltflächen, wenn ein Bereich ausgewählt wird, kann unerwartete Ergebnisse verursachen (z. B. der Datumsbereich bleibt nicht erhalten). Wenn ein einzelner Monat mit einem Bereich von 04.01.2001 bis 04.10.2001 angezeigt wird, ändert das Scrollen des Kalenders den ausgewählten Bereich wie folgt: 03.03.01.2001 bis 03.10.2001. Wenn mehrere Monate angezeigt werden, z. B. März und April mit einem ausgewählten Bereich von 04.01.2001 bis 04.10.2001, wird der Kalender zurück zum Januar scrollen und Februar ändert den ausgewählten Bereich wie folgt: 01.01.2001 bis 01.10.2001.

Hinweis

SelectionRange Das Festlegen eines MonthCalendar Steuerelements mit aktivierten visuellen Formatvorlagen führt dazu, dass der Auswahlbereich nicht ordnungsgemäß auf dem Steuerelement formatiert wird.

Gilt für

Siehe auch