Freigeben über

Übersicht über das Calendar-Webserversteuerelement

  • Artikel

Aktualisiert: November 2007

Mit dem Calendar-Webserversteuerelement können auswählbare Datumswerte in einem Kalender und mit bestimmten Datumswerten verknüpfte Daten dargestellt werden.

Dieses Thema enthält folgende Abschnitte:

  • Szenarien

  • Features

  • Hintergrund

  • Codebeispiele

  • Klassenreferenz

Szenarien

Verwenden Sie das Calendar-Webserversteuerelement, um Folgendes zu tun:

  • Anzeigen und Auswählen von Datumsangaben   Vom Steuerelement wird ein Kalender angezeigt, in dem Benutzer zu einem beliebigen Tag in einem beliebigen Jahr navigieren können. Das Festlegen eines Werts für die SelectedDate-Eigenschaft bewirkt, dass ein bestimmtes Datum in dem Steuerelement hervorgehoben wird. Optional können Benutzer zu einem beliebigen Datum wechseln, indem sie auf einen Tag klicken oder von Monat zu Monat wechseln. Der Kalender kann so konfiguriert werden, dass Benutzer mehrere Datumswerte auswählen können, entweder eine ganze Woche oder einen ganzen Monat.

    Eine Repräsentation des Calendar-Steuerelements mit der Anzeige des Monats Oktober

  • Anzeigen von Terminen oder anderen Informationen in einem Kalenderraster   Mit dem Calendar-Steuerelement können spezifische Details zu einzelnen Tagen angezeigt werden. Dies können zum Beispiel eine Aufgabenliste, ein Ereigniszeitplan oder ähnliche Informationen sein. Mit diesem Feature wird die Anzeige von Tagesinformationen aus einer Datenbank ermöglicht.

Zurück nach oben

Features

Verwenden Sie das Calendar-Steuerelement, um Folgendes zu tun:

  • Aufzeichnen von Benutzerinteraktionen, z. B. die Auswahl eines Datums oder eines Datumsbereichs durch einen Benutzer.

  • Anpassen der Darstellung des Kalenders.

  • Anzeigen von Informationen aus einer Datenbank im Kalender.

Zurück nach oben

Hintergrund

Vom Calendar-Steuerelement werden jeweils die Daten eines Monats angezeigt. Es werden maximal sechs Wochen angezeigt. Das Steuerelement unterstützt verschiedene Datumstypen, die in der folgenden Tabelle beschrieben werden.

Typ des Datums

Beschreibung

TodaysDate

Standardmäßig wird der Wert des aktuellen Datums auf dem Server festgelegt. Das Datum kann jedoch so angepasst werden, dass es für ein anderes Gebietsschema richtig angezeigt wird.

VisibleDate

Dieses Datum bestimmt, welcher Monat im Kalender angezeigt wird. Der Benutzer kann von Monat zu Monat wechseln. Dabei wird das sichtbare Datum geändert, ohne das aktuelle Datum zu beeinflussen. Zwischen Monaten kann navigiert werden, indem das sichtbare Datum programmgesteuert festgelegt wird.

SelectedDate, SelectedDates

Hierbei handelt es sich um das vom Benutzer ausgewählte Datum oder einen Datumsbereich. Ein Benutzer kann im Steuerelement einen einzelnen Tag, eine einzelne Woche oder einen einzelnen Monat auswählen. Er kann jedoch nur zusammenhängende Zeiträume auswählen. Sie können die ausgewählten Daten auch programmgesteuert festlegen. Auf diese Weise können auch nicht zusammenhängende Zeiträume festgelegt werden.

Das Calendar-Steuerelement basiert auf dem DateTime-Objekt. Es unterstützt daher sämtliche Datumswerte, die für dieses Objekt zugelassen sind. Das bedeutet, dass jedes Datum zwischen den Jahren 0 und 9999 n. Chr. angezeigt werden können.

Auf einer ASP.NET-Seite wird das Calendar-Steuerelement als HTML-Tabelle dargestellt. Einige der Steuerelementeigenschaften betreffen daher verschiedene Aspekte der Tabellenformatierung. Manche dieser Eigenschaften werden in einigen älteren Browsern nicht vollständig unterstützt. In diesen Browsern sind deshalb nicht alle Formatierungsfeatures verfügbar.

Aktivieren der Datumsauswahl

In der Standardeinstellung können Benutzer im Kalender auf ein bestimmtes Datum klicken, um es auszuwählen. Wenn das Steuerelement lediglich zur Anzeige des Kalenders verwendet werden soll, kann die Funktion zur Auswahl des Datums deaktiviert werden.

Wenn die Datumsauswahl aktiviert ist, enthält jeder Tag des Kalenders ein LinkButton-Steuerelement, das beim Klicken auf diesen Tag ein Ereignis auslöst. Wenn die Auswahl von Wochen oder Monaten aktiviert ist, wird am Rand des Kalenders eine Spalte von Links hinzugefügt. Sie ermöglicht dem Benutzer die Angabe der Woche, die ausgewählt werden soll.

Anpassen der Darstellung des Kalenders

Kalendereigenschaften können festgelegt werden, um die Farben, die Größe, den Text und andere sichtbare Features des Kalenders zu ändern. Wie in der folgenden Tabelle angezeigt, stehen dazu mehrere Möglichkeiten zur Auswahl.

Anpassungsmethode

Beschreibung

Festlegen von Eigenschaften

Durch das Festlegen von Eigenschaften können Rasterlinien angezeigt und der Tag festgelegt werden, der als erster Tag der Woche angezeigt wird. Es kann auch die Darstellung des Monatsnamens und der Namen der Tage geändert werden.

Festlegen erweiterter Formateigenschaften

Um die Darstellung bestimmter Elemente des Kalenders festzulegen, können vom Style-Objekt abgeleitete Eigenschaften verwendet werden. Dazu gehören das aktuelle Datum und die Titelleiste, die den Monat und Navigationslinks enthält. Diese Stileigenschaften werden in Browsern unterstützt, die Cascading Stylesheets verwenden können. Für ältere Browser wird ein reduzierter Satz von Darstellungsstilen unterstützt.

Anpassen der Darstellung einzelner Tage

Wenn das Steuerelement einzelne Tage ausgibt, löst es ein Ereignis aus. Sie können dieses Ereignis verwenden, um den ausgegebenen Stream zu ändern. Dies ist nicht nur nützlich, um die Darstellung von Tagen zu ändern, sondern auch, um benutzerdefinierte Inhalte für jeden Tag bereitzustellen. Ausführliche Informationen finden Sie unter Gewusst wie: Anpassen einzelner Tage in einem Calendar-Webserversteuerelement.

Aufzeichnen von Benutzerinteraktionen mit dem Calendar-Webserversteuerelement

Das Calendar-Steuerelement löst das SelectionChanged-Ereignis aus, wenn der Benutzer ein Datum oder einen Datumsbereich auswählt. Es löst das VisibleMonthChanged-Ereignis aus, wenn der Benutzer einen neuen Monat anzeigt. Indem Methoden für diese Ereignisse erstellt werden, kann ermittelt werden, welches Datum oder welche Daten der Benutzer ausgewählt hat, und eine entsprechende Reaktion kann festgelegt werden. Diese kann darin bestehen, die Anzeige des Datums anzupassen.

Anzeigen von Informationen aus einer Datenbank im Calendar-Steuerelement

Ein übliches Szenario besteht darin, dass Informationen aus einer Datenbank im Kalender angezeigt werden. So basiert zum Beispiel ein Ereigniskalender häufig auf Informationen, die in einer Datenbank gespeichert sind.

Datenbindung wird vom Calendar-Steuerelement nicht direkt unterstützt, der Kalender als Ganzes wird also nicht an eine Datenquelle gebunden. Stattdessen wird eine Methode für das DayRender-Ereignis des Steuerelements erstellt, die ausgelöst wird, wenn jeder Tag im aktuellen Kalendermonat ausgegeben wird. Im Handler dieses Ereignisses können Informationen aus einer Datenquelle abgefragt und dem Stream hinzugefügt werden, der an den Browser gesendet wird. Ausführliche Informationen finden Sie unter Gewusst wie: Anzeigen von ausgewählten Daten aus einer Datenbank im Calendar-Steuerelement.

Eingabehilfen

Um Benutzern, die Eingabehilfen verwenden, den Zugriff auf das Calendar-Steuerelement zu erleichtern, unterstützt das Steuerelement die Eigenschaft UseAccessibleHeader. Wenn diese Eigenschaft auf den Wert true festgelegt ist (Standardwert), werden die Spaltenüberschriften, die die Namen der Tage enthalten, unter Verwendung von th-HTML-Elementen ausgegeben.

Zurück nach oben

Codebeispiele

Zurück nach oben

Klassenreferenz

Die folgende Tabelle enthält die Klassen, die sich auf das Calendar-Steuerelement beziehen.

Member

Beschreibung

Calendar

Die Hauptklasse des Steuerelements.

CalendarDay

Die Klasse, die ein Datum im Calendar-Steuerelement repräsentiert.

CalendarSelectionMode

Eine Enumeration mit den Datumsauswahlmodi, die im Calendar-Steuerelement verfügbar sind.

Zurück nach oben

Siehe auch

Aufgaben

Gewusst wie: Programmgesteuerte Datumsauswahl in einem Calendar-Webserversteuerelement

Gewusst wie: Anzeigen von ausgewählten Daten aus einer Datenbank im Calendar-Steuerelement

Weitere Ressourcen

Verwenden von ASP.NET-Webserver-Steuerelementen