MonthCalendar.SetSelectionRange-Methode

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub SetSelectionRange ( _
    date1 As DateTime, _
    date2 As DateTime _
)
'Usage
Dim instance As MonthCalendar
Dim date1 As DateTime
Dim date2 As DateTime

instance.SetSelectionRange(date1, date2)

public void SetSelectionRange (
    DateTime date1,
    DateTime date2
)

public:
void SetSelectionRange (
    DateTime date1, 
    DateTime date2
)

public void SetSelectionRange (
    DateTime date1, 
    DateTime date2
)

public function SetSelectionRange (
    date1 : DateTime, 
    date2 : DateTime
)

Parameter

• date1
  Das Anfangsdatum des Auswahlbereichs.

• date2
  Das Enddatum des Auswahlbereichs.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	date1 ist kleiner als das kleinstmögliche Datum für ein Monatskalender-Steuerelement. - oder - date1 ist größer als das größtmögliche Datum für ein Monatskalender-Steuerelement. - oder - date2 ist kleiner als das kleinstmögliche Datum für ein Monatskalender-Steuerelement. - oder - date2 ist größer als das größtmögliche Datum für ein Monatskalender-Steuerelement.

Hinweise

Das Verwenden dieser Methode entspricht in der Funktion dem Festlegen der SelectionRange-Eigenschaft. Sie können das Anfangs- und Enddatum gesondert festlegen, indem Sie entweder die SelectionStart-Eigenschaft oder SelectionEnd-Eigenschaft festlegen.

Wenn Sie den date1-Parameter auf einen größeren Wert als den date2-Parameter festlegen, werden beide Datumsangaben auf den date1-Wert festgelegt.

Hinweis

Wenn in der Kalenderanzeige mit den Navigationsschaltflächen ein Bildlauf durchgeführt wird und gleichzeitig ein Bereich ausgewählt ist, kann dies zu unerwarteten Ergebnissen führen (beispielsweise wird der Datumsbereich nicht beibehalten). Bei der Anzeige eines einzelnen Monats mit einem Bereich vom 01.04.2001 bis zum 10.04.2001 wird beim Durchführen eines Bildlaufs zurück der ausgewählte Bereich wie folgt geändert: 01.03.2001 bis zum 10.03.2001. Wenn mehrere Monate angezeigt werden, z. B. März und April mit einem ausgewählten Bereich vom 01.04.2001 bis zum 10.04.2001, wird beim Durchführen eines Bildlaufs im Kalender zurück zu Januar und Februar der ausgewählte Bereich wie folgt geändert: 01.01.2001 bis zum 10.01.2001.

Hinweis

Durch Festlegen des SelectionRange für ein MonthCalendar-Steuerelement mit aktivierten visuellen Stilen wird der Auswahlbereich im Steuerelement nicht korrekt gezeichnet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MonthCalendar-Klasse
MonthCalendar-Member
System.Windows.Forms-Namespace
SelectionStart
SelectionEnd
SelectionRange