Le contrôle de calendrier est un contrôle réseau riche en fonctionnalités qui fournit les fonctions suivantes :
Afficher un mois à la fois
Choisissez un jour, une semaine ou un mois
Sélectionnez un jour dans une plage
Se déplacer entre les mois
Champ formaté d'affichage des jours
La syntaxe de base du contrôle calendrier est :
<asp:Calender ID = "Calendar1" runat = "server"></asp:Calender>Le contrôle de calendrier possède de nombreuses propriétés et événements, à l'aide desquels vous pouvez personnaliser les opérations et contrôler l'affichage. Le tableau suivant fournit certaines propriétés importantes du contrôle de calendrier :
| propriété | décrire |
|---|---|
| Légende | Obtient ou définit le titre du contrôle de calendrier. |
| LégendeAligner | Obtient ou définit la disposition des titres. |
| Remplissage de cellules | Obtient ou définit l'espace entre les données et les limites des cellules. |
| Espacement des cellules | Obtient ou définit l'espace entre les cellules. |
| Style d'en-tête de jour | Obtient les propriétés de style pour afficher le jour de la semaine. |
| Format du nom du jour | Obtient ou définit le jour de la semaine. |
| Style de jour | Obtient les propriétés de style pour afficher le jour du mois. |
| PremierJourDeLaSemaine | Obtient ou définit le jour de la semaine et l'affiche sur la première ligne. |
| Texte du mois suivant | Obtient ou définit le texte de navigation pour le mois suivant. La valeur par défaut est >. |
| SuivantPrécédentFormat | Obtient ou définit le contrôle de navigation pour le mois suivant ou précédent. |
| AutreMoisJourStyle | Obtient les propriétés de style pour les jours qui n'apparaissent pas dans le mois. |
| Texte du mois précédent | Obtient ou définit le texte de navigation du mois précédent. La valeur par défaut est <. |
| DateSélectionnée | Obtient ou définit la date sélectionnée. |
| Dates sélectionnées | Obtient une collection d'objets DateTime représentant les dates sélectionnées. |
| StyleJourSélectionné | Obtenez les attributs de style de la date sélectionnée. |
| Mode de sélection | Obtient ou définit le mode de sélection pour spécifier si l'utilisateur peut sélectionner un jour, une semaine ou un mois. |
| Sélectionner le texte du mois | Obtient ou définit le texte de l'élément de mois sélectionné dans la colonne du sélecteur. |
| Style de sélecteur | Obtient les propriétés de style de la colonne de sélection de semaine ou de mois. |
| Sélectionner le texte de la semaine | Obtient ou définit l'affichage du texte de l'élément de sélection de semaine dans la colonne du sélecteur. |
| Afficher l'en-tête du jour | Obtient ou définit une valeur indiquant si les en-têtes des jours de la semaine sont affichés. |
| Afficher les lignes de grille | Obtient ou définit si les lignes de la grille seront affichées. |
| AfficherSuivantMoisPrécédent | Obtient ou définit une valeur qui indique si les éléments de navigation du mois suivant et du mois précédent sont affichés dans la section d'en-tête. |
| Afficher le titre | Obtient ou définit une valeur indiquant si la section de titre est affichée. |
| TitreFormat | Obtient ou définit le format du titre. |
| Style de titre | Obtient la propriété de style du titre du contrôle de date. |
| Aujourd'huiJourStyle | Obtient les propriétés de style de la date du jour. |
| Date d'aujourd'hui | Obtient ou définit la valeur de la date du jour. |
| UtiliserAccessibleHeader | Obtient ou définit une valeur qui indique s'il faut restituer l'élément HTML <th> du titre du tableau dans l'en-tête de date au lieu de l'élément HTML <td> des données du tableau. |
| DateVisible | Obtient ou définit la date du mois spécifié et l'affiche. |
| Week-endJourStyle | Obtient ou définit l'attribut de style pour les dates du week-end. |
Le contrôle de date comporte les trois événements les plus importants suivants pour permettre aux développeurs d'écrire des contrôles de date. Ils sont:
| événement | décrire |
|---|---|
| SélectionModifiée | Il se déclenche lorsqu'un jour, une semaine ou un mois est sélectionné. |
| Rendu du jour | Il est déclenché à chaque fois que la cellule de données du contrôle calendrier est restituée. |
| VisibleMonthChanged | Il se déclenche lorsque l'utilisateur change de mois. |
Utilisez un contrôle de calendrier initial sans aucun code pour fournir au site Web un calendrier valide affichant les mois et les jours de l'année. Il contient également la navigation pour le mois suivant et le mois précédent.
Le contrôle du calendrier permet à l'utilisateur de sélectionner un jour, une semaine ou un mois entier. Ceci est accompli à l'aide de la propriété SelectionMode. Cet attribut a les valeurs suivantes :
| propriété | décrire |
|---|---|
| Jour | Choisissez un jour. |
| JourSemaine | Choisissez une journée ou une semaine entière. |
| JourSemaineMois | Choisissez un jour, une semaine ou un mois entier. |
| Aucun | Rien ne peut être sélectionné. |
Syntaxe de sélection des dates :
<asp:Calender ID = "Calendar1" runat = "server" SelectionMode="DayWeekMonth"></asp:Calender>Lorsque le mode de sélection est DayWeekMonth, une colonne supplémentaire marquée du symbole > apparaît pour sélectionner la semaine, et le symbole >> apparaît à gauche du nom du jour pour sélectionner le mois.
L'exemple suivant montre la sélection d'une date et son affichage dans une étiquette :
Le code du fichier de contenu est le suivant :
<%@ 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>Gestionnaire d'événements pour l'événement SelectionChanged :
protected void Calendar1_SelectionChanged(object sender, EventArgs e){ lblday.Text = Calendar1.TodaysDate.ToShortDateString(); lblbday.Text = Calendar1.SelectedDate.ToShortDateString();}Lorsque vous exécutez ce fichier, il génère le résultat suivant :
