Exporter (0) Imprimer
Développer tout

Calendar, classe

Mise à jour : novembre 2007

Affiche un calendrier mensuel qui permet à l'utilisateur de sélectionner des dates et de passer au mois suivant ou précédent.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

[ControlValuePropertyAttribute("SelectedDate", typeof(DateTime), "1/1/0001")]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class Calendar : WebControl, IPostBackEventHandler
/** @attribute ControlValuePropertyAttribute("SelectedDate", DateTime, "1/1/0001") */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class Calendar extends WebControl implements IPostBackEventHandler
public class Calendar extends WebControl implements IPostBackEventHandler
<asp:Calendar />

Utilisez le contrôle Calendar pour afficher un seul mois du calendrier sur une page Web. Le contrôle vous permet de sélectionner des dates et de passer au mois suivant ou précédent. Le contrôle Calendar prend en charge tous les types System.Globalization.Calendar de l'espace de noms System.Globalization. Hormis le calendrier grégorien, des calendriers qui utilisent des systèmes annuels et mensuels différents, tels que le calendrier Hjiri, sont également inclus.

Vous pouvez spécifier si le contrôle Calendar vous permet de sélectionner un seul jour, une seule semaine ou un mois entier en définissant la propriété SelectionMode.

Par défaut, le contrôle affiche les jours du mois, les en-têtes des jours de la semaine, un titre avec le nom du mois et l'année, ainsi que des liens pour sélectionner des jours individuels du mois et des liens pour passer au mois suivant et précédent. Vous pouvez personnaliser l'apparence du contrôle Calendar en définissant les propriétés qui contrôlent le style des différentes parties du contrôle. Le tableau suivant répertorie les propriétés qui spécifient le style des différentes parties du contrôle.

Propriété

Description

DayHeaderStyle

Spécifie le style de la section qui affiche les jours de la semaine.

DayStyle

Spécifie le style des dates du mois affiché.

NextPrevStyle

Spécifie le style des contrôles de navigation contenus dans la section du titre.

OtherMonthDayStyle

Spécifie le style des dates qui ne figurent pas dans le mois actuellement affiché.

SelectedDayStyle

Spécifie le style des dates sélectionnées sur le calendrier.

SelectorStyle

Spécifie le style de la colonne de sélection des dates du mois et de la semaine.

TitleStyle

Spécifie le style de la section du titre.

TodayDayStyle

Spécifie le style de la date du jour.

WeekendDayStyle

Spécifie le style des dates de week-end.

Vous pouvez également afficher ou masquer différentes parties du contrôle. Le tableau suivant énumère les propriétés qui contrôlent les parties qui sont affichées ou masquées.

Propriété

Description

ShowDayHeader

Affiche ou masque la section qui affiche les jours de la semaine.

ShowGridLines

Affiche ou masque le quadrillage entre les jours du mois.

ShowNextPrevMonth

Affiche ou masque les contrôles de navigation vers le mois suivant ou précédent.

ShowTitle

Affiche ou masque la section du titre.

Même si la liaison à une source de données n'est pas prise en charge pour le contrôle Calendar, vous pouvez modifier le contenu et la mise en forme des cellules de dates individuelles. Avant que le contrôle Calendar ne s'affiche sur la page Web, il crée ses propres composants et les assemble. L'événement DayRender est déclenché lors de la création de chaque cellule de date dans le contrôle Calendar. Vous pouvez contrôler le contenu et la mise en forme d'une cellule de date lors de sa création en fournissant du code dans le gestionnaire d'événements de l'événement DayRender. Pour plus d'informations sur la personnalisation du contenu d'une cellule de date, consultez OnDayRender.

Remarque :

Le contrôle Calendar restitue ECMAScript (JScript, JavaScript) sur le navigateur client. L'ECMAScript doit être activé sur le navigateur client pour que ce contrôle fonctionne correctement. Pour plus d'informations sur le script client, consultez Script client dans les pages Web ASP.NET.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions WCAG (Web Content Accessibility Guidelines) 1.0 de priorité 1. Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

TopicLocation
Comment : contrôler la sélection de la date par l'utilisateur dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET
Comment : contrôler la navigation entre les mois dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET
Comment : personnaliser l'apparence du contrôle serveur Web CalendarGénération d'applications Web ASP.NET
Comment : personnaliser des journées dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET
Comment : définir la date actuelle par programme dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET
Comment : lire les dates sélectionnées dans le contrôle serveur Web CalendarGénération d'applications Web ASP.NET
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : mettre en forme des éléments du contrôle serveur Web Calendar à l'aide de stylesGénération d'applications Web ASP.NET
Comment : répondre à la sélection de la date dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET
Comment : afficher des dates sélectionnées d'une base de données dans le contrôle CalendarGénération d'applications Web ASP.NET
Procédure pas à pas : personnalisation d'un site Web à l'aide de thèmes dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Comment : mettre en forme des éléments du contrôle serveur Web Calendar à l'aide de stylesGénération d'applications Web ASP.NET dans Visual Studio
Comment : contrôler la sélection de la date par l'utilisateur dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Comment : répondre à la sélection de la date dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser des journées dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir la date actuelle par programme dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web de base dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : afficher des dates sélectionnées d'une base de données dans le contrôle CalendarGénération d'applications Web ASP.NET dans Visual Studio
Comment : contrôler la navigation entre les mois dans un contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Comment : lire les dates sélectionnées dans le contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : personnalisation d'un site Web à l'aide de thèmes dans Visual StudioGénération d'applications à l'aide de Visual Web Developer
Comment : personnaliser l'apparence du contrôle serveur Web CalendarGénération d'applications Web ASP.NET dans Visual Studio

L'exemple de code suivant illustre la création d'un contrôle Calendar sur une page Web.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>ASP.NET Example</title>
</head>
<body>

   <form id="form1" 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>



L'exemple suivant illustre un contrôle Calendar utilisé lors de la modification de l'une des colonnes affichées par un contrôle GridView. Le contrôle Calendar est lié à la source de données à l'aide de la méthode Bind. La méthode Eval est utilisée pour lier la valeur de date qui est affichée par le contrôle Calendar.

<Columns>                  
  <asp:BoundField DataField="EmployeeID" HeaderText="Employee ID" ReadOnly="true"/>                    
  <asp:BoundField DataField="FirstName"  HeaderText="First Name"/>
  <asp:BoundField DataField="LastName"   HeaderText="Last Name"/>                    
  <asp:TemplateField HeaderText="Birth Date">
    <ItemTemplate> 
      <asp:Label ID="BirthDateLabel" Runat="Server" 
                 Text='<%# Eval("BirthDate", "{0:d}") %>' />
    </ItemTemplate>
    <EditItemTemplate>
      <asp:Calendar ID="EditBirthDateCalendar" Runat="Server"
                    VisibleDate='<%# Eval("BirthDate") %>'
                    SelectedDate='<%# Bind("BirthDate") %>' />
    </EditItemTemplate>
  </asp:TemplateField> 
  <asp:HyperLinkField Text="Show Detail"
                      DataNavigateUrlFormatString="~/ShowEmployeeDetail.aspx?EmployeeID={0}"
                      DataNavigateUrlFields="EmployeeID" />                   
</Columns> 


Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft