Deklarative Syntax des Calendar-Webserversteuerelements
Aktualisiert: November 2007
Zeigt einen Monatskalender an, in dem der Benutzer ein Datum auswählen und zum nächsten bzw. vorherigen Monat wechseln kann.
<asp:Calendar
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DayNameFormat="Full|Short|FirstLetter|FirstTwoLetters|Shortest"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FirstDayOfWeek="Sunday|Monday|Tuesday|Wednesday|Thursday|Friday|
Saturday|Default"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
NextMonthText="string"
NextPrevFormat="CustomText|ShortMonth|FullMonth"
OnDataBinding="DataBinding event handler"
OnDayRender="DayRender event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectionChanged="SelectionChanged event handler"
OnUnload="Unload event handler"
OnVisibleMonthChanged="VisibleMonthChanged event handler"
PrevMonthText="string"
runat="server"
SelectedDate="string"
SelectionMode="None|Day|DayWeek|DayWeekMonth"
SelectMonthText="string"
SelectWeekText="string"
ShowDayHeader="True|False"
ShowGridLines="True|False"
ShowNextPrevMonth="True|False"
ShowTitle="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
TitleFormat="Month|MonthYear"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
VisibleDate="string"
Width="size"
>
<DayHeaderStyle/>
<DayStyle/>
<NextPrevStyle/>
<OtherMonthDayStyle/>
<SelectedDayStyle/>
<SelectorStyle/>
<TitleStyle/>
<TodayDayStyle/>
<WeekendDayStyle/>
</asp:Calendar>
Hinweise
Mit dem Calendar-Steuerelement kann ein Monatskalender angezeigt werden, in dem der Benutzer ein Datum auswählen und zum nächsten bzw. vorigen Monat wechseln kann.
Durch Festlegen der SelectionMode-Eigenschaft können Sie angeben, ob der Benutzer einen einzelnen Tag, eine Woche oder einen gesamten Monat auswählen kann. Sie können die Funktion zur Datumsauswahl auch vollständig deaktivieren.
Durch Festlegen der Stileigenschaften für die verschiedenen Teile des Steuerelements können Sie die Darstellung des Calendar-Steuerelements anpassen. In der folgenden Tabelle sind die verschiedenen Stileigenschaften für das Calendar-Steuerelement aufgelistet.
Style-Objekt |
Beschreibung |
Style-Klasse |
|---|---|---|
Das Format für den Kalenderabschnitt, in dem die Namen der Wochentage angezeigt werden. |
||
Das Format für die einzelnen Tage im angezeigten Monat. Tipp Den Wochenenden, dem aktuellen Datum und dem ausgewählten Tag können unterschiedliche Stile zugewiesen werden, und zwar durch Festlegen der Eigenschaften WeekendDayStyle, TodayDayStyle bzw. SelectedDayStyle. |
||
Der Stil der Abschnitte am linken und rechten Ende der Titelleiste, wo sich die LinkButton-Steuerelemente für die Auswahl des Monats befinden. |
||
Das Format für die Tage aus dem vorherigen und nächsten Monat, die im aktuellen Monat angezeigt werden. |
||
Das Format für das ausgewählte Datum. Tipp Wenn diese Eigenschaft nicht festgelegt wurde, wird der in der DayStyle-Eigenschaft angegebene Stil für die Anzeige des ausgewählten Datums verwendet. |
||
Der Stil für die Spalte auf der linken Seite des Calendar-Steuerelements, die die Links für die Auswahl einer Woche oder des gesamten Monats enthält. |
||
Das Format für die Titelleiste am oberen Rand des Kalenders, die den Monatsnamen und die Links für die Auswahl des Monats enthält. Tipp Wenn NextPrevStyle festgelegt wurde, überschreibt diese Eigenschaft den Stil der Navigationssteuerelemente für den vorherigen und den folgenden Monat, die sich an den Enden der Titelleiste befinden. |
||
Das Format für das aktuelle Datum. Tipp Wenn diese Eigenschaft nicht festgelegt wurde, wird der in der DayStyle-Eigenschaft angegebene Stil für die Anzeige des aktuellen Datums verwendet. |
||
Das Format für die Wochenendtage. Tipp Wenn diese Eigenschaft nicht festgelegt wurde, wird der in der DayStyle-Eigenschaft angegebene Stil für die Anzeige der Wochenenddaten verwendet. |
Sie können die Darstellung des Calendar-Steuerelements auch steuern, indem Sie einzelne Teile des Steuerelements ein- oder ausblenden. In der folgenden Tabelle werden die Teile des Calendar-Steuerelements aufgelistet, die ein- oder ausgeblendet werden können.
Eigenschaft |
Beschreibung |
|---|---|
Blendet den Abschnitt ein oder aus, in dem die Wochentage angezeigt werden. |
|
Blendet die Rasterlinien zwischen den Tagen des Monats ein oder aus. |
|
Blendet die Steuerelemente für die Navigation zum nächsten oder vorherigen Monat ein oder aus. |
|
Blendet den Titelabschnitt ein oder aus. |
Obwohl das Calendar-Steuerelement die Bindung an Datenquellen nicht überstützt, können Sie den Inhalt und die Formatierung der einzelnen Datumszellen bearbeiten. Vor der Anzeige des Calendar-Steuerelements auf der Webseite werden die Komponenten erstellt und assembliert, aus denen das Steuerelement besteht. Das DayRender-Ereignis wird beim Erstellen jeder einzelnen Datumszelle im Calendar-Steuerelement ausgelöst. Sie können beim Erstellen einer Datumszelle deren Inhalt und Formatierung steuern, indem Sie im Ereignishandler für das DayRender-Ereignis Code einfügen.
Hinweis: Das Calendar-Steuerelement stellt JavaScript im Clientbrowser dar. Im Clientbrowser muss JavaScript aktiviert sein, damit dieses Steuerelement ordnungsgemäß funktioniert. Weitere Informationen zu Clientskript finden Sie unter Clientskript in ASP.NET-Webseiten.
Weitere Informationen über die Eigenschaften, die für jede Formatklasse unterstützt werden, finden Sie unter Eigenschaften von Style-Objekten.
Ausführliche Informationen zu den Eigenschaften und Ereignissen des Calendar-Steuerelements finden Sie in der Dokumentation zur Calendar-Klasse.
Beispiel
Das folgende Beispiel zeigt eine Beispieldeklaration für ein Calendar-Steuerelementin einer ASPX-Datei. Die Deklaration enthält eine Reihe von Stilobjekteigenschaften und legt die Date_Selected-Methode als Handler für das SelectionChanged-Ereignis fest.
<asp:Calendar id="Calendar2"
OnSelectionChanged="Date_Selected"
SelectionMode="DayWeekMonth"
Font-Name="Verdana"
Font-Size="12px"
NextPrevFormat="ShortMonth"
SelectWeekText="week"
SelectMonthText="month"
runat="server">
<TodayDayStyle Font-Bold="True"/>
<DayHeaderStyle Font-Bold="True"/>
<OtherMonthDayStyle ForeColor="gray"/>
<TitleStyle BackColor="#3366ff"
ForeColor="white"
Font-Bold="True"/>
<SelectedDayStyle BackColor="#ffcc66"
Font-Bold="True"/>
<NextPrevStyle ForeColor="white"
Font-Size="10px"/>
<SelectorStyle BackColor="#99ccff"
ForeColor="navy"
Font-Size="9px"/>
</asp:Calendar>
Das folgende Beispiel zeigt eine Ereignisbehandlungsmethode für das SelectionChanged-Ereignis eines Calendar-Steuerelements. Durch Abfragen des SelectedDates-Parameters des Calendar-Steuerelements können Sie bestimmen, wie viele Tage ausgewählt wurden, ob der Benutzer also einen Tag, eine Woche oder einen Monat ausgewählt hat. Informationen zur Auswahl werden in einem Label-Webserversteuerelement angezeigt.
Sub Date_Selected(sender as Object sender, e As EventArgs)
Select (Calendar1.SelectedDates.Count)
Case 0: 'None
Label1.Text = "No dates are currently selected"
Case 1: 'Day
Label1.Text = "The selected date is " & _
Calendar1.SelectedDate.ToShortDateString
Case 7: 'Week
Label1.Text = "The selection is a week beginning " & _
Calendar1.SelectedDate.ToShortDateString
Case Else: 'Month
Label1.Text = "The selection is a month beginning " & _
Calendar1.SelectedDate.ToShortDateString
End Select
End Sub
protected void Date_Selected(object sender, EventArgs e)
{
switch (Calendar1.SelectedDates.Count)
{
case (0): //None
{
Label1.Text = "No dates are currently selected";
break;
}
case (1): //Day
{
Label1.Text = "The selected date is " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
case (7): //Week
{
Label1.Text = "The selection is a week beginning " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
default: //Month
Label1.Text = "The selection is a month beginning " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
}
Siehe auch
Konzepte
Übersicht über das Calendar-Webserversteuerelement