Calendar-Klasse
Zeigt einen Kalender für einen Monat an, in dem der Benutzer ein Datum auswählen und zum nächsten bzw. vorherigen Monat wechseln kann.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ControlValuePropertyAttribute("SelectedDate", GetType(DateTime), "1/1/0001")> _
Public Class Calendar
Inherits WebControl
Implements IPostBackEventHandler
'Usage
Dim instance As Calendar
[ControlValuePropertyAttribute("SelectedDate", typeof(DateTime), "1/1/0001")]
public class Calendar : WebControl, IPostBackEventHandler
[ControlValuePropertyAttribute(L"SelectedDate", typeof(DateTime), L"1/1/0001")]
public ref class Calendar : public WebControl, IPostBackEventHandler
/** @attribute ControlValuePropertyAttribute("SelectedDate", System.DateTime, "1/1/0001") */
public class Calendar extends WebControl implements IPostBackEventHandler
ControlValuePropertyAttribute("SelectedDate", System.DateTime, "1/1/0001")
public class Calendar extends WebControl implements IPostBackEventHandler
Hinweise
Mit dem Calendar-Steuerelement können Sie einen einzelnen Monat in einem Kalender auf einer Webseite anzeigen. Mit dem Steuerelement können Sie ein Datum auswählen und zum nächsten bzw. vorherigen Monat wechseln. Das Calendar-Steuerelement unterstützt alle System.Globalization.Calendar-Typen im System.Globalization-Namespace. Neben dem gregorianischen Kalender gehören hierzu auch Kalender mit einem anderen Jahres- und Monatssystem, z. B. der Hjiri-Kalender.
Durch Festlegen der SelectionMode-Eigenschaft können Sie angeben, ob mit dem Calendar-Steuerelement ein einzelner Tag, eine Woche oder ein ganzer Monat ausgewählt werden kann.
Standardmäßig zeigt das Steuerelement die Tage des Monats, Tagesüberschriften für die Wochentage, einen Titel mit dem Namen des Monats und mit dem Jahr, Verknüpfungen für die Auswahl von individuellen Tagen des Monats sowie Verknüpfungen für die Navigation zum nächsten und vorherigen Monat an. Sie können die Darstellung des Calendar-Steuerelements anpassen, indem Sie die Eigenschaften festlegen, mit denen der Stil für verschiedene Bereiche des Steuerelements gesteuert wird. In der folgenden Tabelle werden die Eigenschaften aufgeführt, mit denen der Stil für die verschiedenen Bereiche des Steuerelements angegeben wird.
Eigenschaft |
Beschreibung |
|---|---|
Gibt den Stil für den Abschnitt an, in dem die Wochentage angezeigt werden. |
|
Gibt den Stil für die Datumsangaben im angezeigten Monat an. |
|
Gibt den Stil für die Navigationssteuerelemente im Titelbereich an. |
|
Gibt den Stil für die Datumsangaben an, die nicht zum derzeit angezeigten Monat gehören. |
|
Gibt den Stil für die im Kalender ausgewählten Datumsangaben an. |
|
Gibt den Stil der Auswahlspalte für Datumsangaben von Wochen und Monaten an. |
|
Gibt den Stil für den Titelabschnitt an. |
|
Gibt den Stil für das heutige Datum an. |
|
Gibt den Stil für die Wochenenden an. |
Sie können auch verschiedene Bereiche des Steuerelements anzeigen und ausblenden. In der folgenden Tabelle sind die Eigenschaften aufgeführt, mit denen gesteuert wird, welche Bereiche angezeigt oder ausgeblendet werden.
Eigenschaft |
Beschreibung |
|---|---|
Zeigt den Abschnitt an, in dem die Wochentage angezeigt werden, oder blendet diesen aus. |
|
Zeigt die Rasterlinien zwischen den Tagen des Monats an oder blendet diese aus. |
|
Zeigt die Steuerelemente für die Navigation zum nächsten bzw. vorherigen Monat an oder blendet diese aus. |
|
Zeigt den Titelabschnitt an oder blendet diesen aus. |
Die Bindung an eine Datenquelle wird für das Calendar-Steuerelement zwar nicht unterstützt. Sie können jedoch Inhalt und Formatierung der einzelnen Datumszellen ändern. Vor der Anzeige des Calendar-Steuerelements auf der Webseite erstellt und assembliert dieses die Komponenten, die das Steuerelement bilden. Das DayRender-Ereignis wird beim Erstellen jeder einzelnen Datumszelle im Calendar-Steuerelement ausgelöst. Sie können beim Erstellen einer Datumszelle Inhalt und Formatierung steuern, indem Sie Code für das DayRender-Ereignis im Ereignishandler bereitstellen. Weitere Informationen zum Anpassen des Inhalts einer Zelle mit Datumsangaben finden Sie unter OnDayRender.
Hinweis
Das Calendar-Steuerelement gibt auf dem Clientbrowser ECMAScript (JScript, JavaScript) wieder. Im Clientbrowser muss ECMAScript aktiviert sein, damit dieses Steuerelement ordnungsgemäß funktioniert. Weitere Informationen zu Clientskripts finden Sie unter Clientskript in ASP.NET-Webseiten.
Eingabehilfen
Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.
Beispiel
Im folgenden Codebeispiel wird das Erstellen eines Calendar-Steuerelements auf einer Webseite veranschaulicht.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<form runat="server">
<asp:Calendar id="calendar1" runat="server">
<OtherMonthDayStyle ForeColor="LightGray">
</OtherMonthDayStyle>
<TitleStyle BackColor="Blue"
ForeColor="White">
</TitleStyle>
<DayStyle BackColor="gray">
</DayStyle>
<SelectedDayStyle BackColor="LightGray"
Font-Bold="True">
</SelectedDayStyle>
</asp:Calendar>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<form runat="server">
<asp:Calendar id="calendar1" runat="server">
<OtherMonthDayStyle ForeColor="LightGray">
</OtherMonthDayStyle>
<TitleStyle BackColor="Blue"
ForeColor="White">
</TitleStyle>
<DayStyle BackColor="gray">
</DayStyle>
<SelectedDayStyle BackColor="LightGray"
Font-Bold="True">
</SelectedDayStyle>
</asp:Calendar>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<form runat="server">
<asp:Calendar id="calendar1" runat="server">
<OtherMonthDayStyle ForeColor="LightGray">
</OtherMonthDayStyle>
<TitleStyle BackColor="Blue"
ForeColor="White">
</TitleStyle>
<DayStyle BackColor="gray">
</DayStyle>
<SelectedDayStyle BackColor="LightGray"
Font-Bold="True">
</SelectedDayStyle>
</asp:Calendar>
</form>
</body>
</html>
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Calendar
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, 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
Calendar-Member
System.Web.UI.WebControls-Namespace
SelectionMode
DayHeaderStyle
DayStyle
NextPrevStyle
OtherMonthDayStyle
SelectedDayStyle
SelectorStyle
TitleStyle
TodayDayStyle
WeekendDayStyle
ShowDayHeader
ShowGridLines
ShowNextPrevMonth
ShowTitle
Weitere Ressourcen
Clientskript in ASP.NET-Webseiten
Calendar-Webserver-Steuerelement