Freigeben über


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

DayHeaderStyle

Gibt den Stil für den Abschnitt an, in dem die Wochentage angezeigt werden.

DayStyle

Gibt den Stil für die Datumsangaben im angezeigten Monat an.

NextPrevStyle

Gibt den Stil für die Navigationssteuerelemente im Titelbereich an.

OtherMonthDayStyle

Gibt den Stil für die Datumsangaben an, die nicht zum derzeit angezeigten Monat gehören.

SelectedDayStyle

Gibt den Stil für die im Kalender ausgewählten Datumsangaben an.

SelectorStyle

Gibt den Stil der Auswahlspalte für Datumsangaben von Wochen und Monaten an.

TitleStyle

Gibt den Stil für den Titelabschnitt an.

TodayDayStyle

Gibt den Stil für das heutige Datum an.

WeekendDayStyle

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

ShowDayHeader

Zeigt den Abschnitt an, in dem die Wochentage angezeigt werden, oder blendet diesen aus.

ShowGridLines

Zeigt die Rasterlinien zwischen den Tagen des Monats an oder blendet diese aus.

ShowNextPrevMonth

Zeigt die Steuerelemente für die Navigation zum nächsten bzw. vorherigen Monat an oder blendet diese aus.

ShowTitle

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.

Thema Position
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer einfachen Webseite in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anpassen einer Website mithilfe von Designs in Visual Studio Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer Erstellen von Anwendungen mit Visual Web Developer
Exemplarische Vorgehensweise: Anpassen einer Website mithilfe von Designs in Visual Studio Erstellen von Anwendungen mit Visual Web Developer
Gewusst wie: Formatieren von Elementen des Calendar-Webserversteuerelements mit Formaten Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Steuern der Benutzerdatumsauswahl in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf eine Datumsauswahl in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anpassen einzelner Tage in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Festlegen des aktuellen Datums in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer einfachen Webseite in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anzeigen von ausgewählten Daten aus einer Datenbank im Calendar-Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Steuern der Monatsnavigation in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Lesen ausgewählter Datumsangaben in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anpassen der Darstellung von Calendar-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Formatieren von Elementen des Calendar-Webserversteuerelements mit Formaten Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Steuern der Benutzerdatumsauswahl in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf eine Datumsauswahl in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anpassen einzelner Tage in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Festlegen des aktuellen Datums in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer einfachen Webseite in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anzeigen von ausgewählten Daten aus einer Datenbank im Calendar-Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Steuern der Monatsnavigation in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Lesen ausgewählter Datumsangaben in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anpassen der Darstellung von Calendar-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Formatieren von Elementen des Calendar-Webserversteuerelements mit Formaten Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Steuern der Benutzerdatumsauswahl in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Reagieren auf eine Datumsauswahl in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Anpassen einzelner Tage in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Festlegen des aktuellen Datums in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Anzeigen von ausgewählten Daten aus einer Datenbank im Calendar-Steuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Steuern der Monatsnavigation in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Lesen ausgewählter Datumsangaben in einem Calendar-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Anpassen der Darstellung von Calendar-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen

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