Das Kalendersteuerelement ist ein funktionsreiches Netzwerksteuerelement, das die folgenden Funktionen bereitstellt:
Zeigen Sie jeweils einen Monat an
Wählen Sie einen Tag, eine Woche oder einen Monat
Wählen Sie einen Tag innerhalb eines Bereichs aus
Wechseln Sie zwischen den Monaten
Formatierte Steuerung der Anzeige von Tagen
Die grundlegende Syntax des Kalendersteuerelements lautet:
<asp:Calender ID = "Calendar1" runat = "server"></asp:Calender>Das Kalendersteuerelement verfügt über viele Eigenschaften und Ereignisse, mit denen Sie Vorgänge anpassen und die Anzeige steuern können. Die folgende Tabelle enthält einige wichtige Eigenschaften des Kalendersteuerelements:
| Eigentum | beschreiben |
|---|---|
| Untertitel | Ruft den Titel des Kalendersteuerelements ab oder legt diesen fest. |
| CaptionAlign | Ruft die Anordnung der Titel ab oder legt diese fest. |
| CellPadding | Ruft den Abstand zwischen Daten und Zellgrenzen ab oder legt diesen fest. |
| Zellabstand | Ruft den Abstand zwischen Zellen ab oder legt diesen fest. |
| DayHeaderStyle | Ruft Stileigenschaften ab, um den Wochentag anzuzeigen. |
| DayNameFormat | Ruft den Wochentag ab oder legt diesen fest. |
| DayStyle | Ruft die Stileigenschaften ab, um den Tag des Monats anzuzeigen. |
| FirstDayOfWeek | Ruft den Wochentag ab oder legt ihn fest und zeigt ihn in der ersten Zeile an. |
| NextMonthText | Ruft den Navigationstext für den nächsten Monat ab oder legt ihn fest. Der Standardwert ist >. |
| NextPrevFormat | Ruft das Navigationssteuerelement für den nächsten oder vorherigen Monat ab oder legt es fest. |
| OtherMonthDayStyle | Ruft die Stileigenschaften für Tage ab, die nicht im Monat erscheinen. |
| VorherigerMonatText | Ruft den Navigationstext des vorherigen Monats ab oder legt diesen fest. Der Standardwert ist <. |
| Ausgewähltes Datum | Ruft das ausgewählte Datum ab oder legt es fest. |
| Ausgewählte Daten | Ruft eine Auflistung von DateTime-Objekten ab, die die ausgewählten Daten darstellen. |
| SelectedDayStyle | Rufen Sie die Stilattribute des ausgewählten Datums ab. |
| Auswahlmodus | Ruft den Auswahlmodus ab oder legt diesen fest, um anzugeben, ob der Benutzer einen Tag, eine Woche oder einen Monat auswählen kann. |
| Wählen SieMonatstext aus | Ruft den Text des ausgewählten Monatselements in der Auswahlspalte ab oder legt diesen fest. |
| SelectorStyle | Ruft die Stileigenschaften der Wochen- oder Monatsauswahlspalte ab. |
| SelectWeekText | Ruft die Textanzeige des Wochenauswahlelements in der Auswahlspalte ab oder legt diese fest. |
| ShowDayHeader | Ruft einen Wert ab, der angibt, ob Kopfzeilen für Wochentage angezeigt werden, oder legt diesen fest. |
| Gitterlinien anzeigen | Ruft ab oder legt fest, ob die Rasterlinien angezeigt werden. |
| ShowNextPrevMonth | Ruft einen Wert ab oder legt diesen fest, der angibt, ob Navigationselemente für den nächsten Monat und den vorherigen Monat im Kopfbereich angezeigt werden. |
| Titel anzeigen | Ruft einen Wert ab, der angibt, ob der Titelabschnitt angezeigt wird, oder legt diesen fest. |
| TitleFormat | Ruft das Format des Titels ab oder legt es fest. |
| Titelstil | Ruft die Style-Eigenschaft des Titels des Datumssteuerelements ab. |
| TodayDayStyle | Ruft die Stileigenschaften des heutigen Datums ab. |
| Heutiges Datum | Ruft den Wert des heutigen Datums ab oder legt diesen fest. |
| Verwenden Sie AccessibleHeader | Ruft einen Wert ab oder legt einen Wert fest, der anzeigt, ob das HTML-Element „Tabellentitel <th>“ im Datumsheader anstelle des HTML-Elements „Tabellendaten“ <td> gerendert werden soll. |
| Sichtbares Datum | Ruft das Datum des angegebenen Monats ab oder legt es fest und zeigt es an. |
| WeekendDayStyle | Ruft das Stilattribut für Wochenenddaten ab oder legt es fest. |
Das Datumssteuerelement verfügt über die folgenden drei wichtigsten Ereignisse, damit Entwickler Datumssteuerelemente schreiben können. Sie sind:
| Ereignis | beschreiben |
|---|---|
| Auswahl geändert | Es wird ausgelöst, wenn ein Tag, eine Woche oder ein Monat ausgewählt wird. |
| DayRender | Es wird jedes Mal ausgelöst, wenn die Datenzelle des Kalendersteuerelements gerendert wird. |
| VisibleMonthChanged | Es wird ausgelöst, wenn der Benutzer den Monat ändert. |
Verwenden Sie ein anfängliches Kalendersteuerelement ohne Code, um der Website einen gültigen Kalender bereitzustellen, der die Monate und Tage des Jahres anzeigt. Es enthält auch die Navigation für den nächsten Monat und den Vormonat.
Mit der Kalendersteuerung kann der Benutzer einen Tag, eine Woche oder einen ganzen Monat auswählen. Dies wird mithilfe der SelectionMode-Eigenschaft erreicht. Dieses Attribut hat die folgenden Werte:
| Eigentum | beschreiben |
|---|---|
| Tag | Wählen Sie einen Tag. |
| TagWoche | Wählen Sie einen Tag oder eine ganze Woche. |
| TagWocheMonat | Wählen Sie einen Tag, eine Woche oder einen ganzen Monat. |
| Keiner | Es kann nichts ausgewählt werden. |
Syntax zur Datumsauswahl:
<asp:Calender ID = "Calendar1" runat = "server" SelectionMode="DayWeekMonth"></asp:Calender>Wenn der Auswahlmodus DayWeekMonth ist, erscheint eine zusätzliche Spalte mit dem Symbol > zur Auswahl der Woche und das Symbol >> links neben dem Tagesnamen zur Auswahl des Monats.
Das folgende Beispiel zeigt die Auswahl eines Datums und dessen Anzeige in einem Etikett:
Der Inhaltsdateicode lautet wie folgt:
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="calendardemo._Default" %><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title> Untitled Page </title> </head> <body> <form id="form1" runat="server"> <div> <h3> Your Birthday:</h3> <asp:Calendar ID="Calendar1" runat="server SelectionMode="DayWeekMonth" onselectionchanged="Calendar1_SelectionChanged"> </asp:Calendar> </div> <p>Todays date is: <asp:Label ID="lblday" runat="server"></asp:Label> </p> <p>Your Birday is: <asp:Label ID="lblbday" runat="server"></asp:Label> </p> </form> </body></html>Ereignishandler für das Ereignis SelectionChanged:
protected void Calendar1_SelectionChanged(object sender, EventArgs e){ lblday.Text = Calendar1.TodaysDate.ToShortDateString(); lblbday.Text = Calendar1.SelectedDate.ToShortDateString();}Wenn Sie diese Datei ausführen, wird die folgende Ausgabe generiert:
