Vue d'ensemble du contrôle serveur Web Calendar

Mise à jour : novembre 2007

Le contrôle serveur Web Calendar peut être utilisé pour afficher des dates sélectionnables dans un calendrier et afficher des données associées à des dates spécifiques.

Cette rubrique contient les sections suivantes :

• Scénarios

• Fonctionnalités

• Contexte

• Exemples de code

• Référence de classe

Scénarios

Vous pouvez utiliser le contrôle serveur Web Calendar pour effectuer les tâches suivantes :

• Affichage et sélection de dates   Le contrôle affiche un calendrier dans lequel les utilisateurs peuvent se placer sur n'importe quel jour de n'importe quelle année. Lorsque vous définissez la propriété SelectedDate, une date est affichée en surbrillance dans le contrôle. Les utilisateurs peuvent également se déplacer jusqu'à la date de leur choix en cliquant sur une journée ou en passant de mois en mois. Le calendrier peut être configuré de telle sorte que les utilisateurs puissent y sélectionner plusieurs dates, une semaine complète ou même un mois entier.

  Représentation du contrôle Calendar affichant le mois d'octobre
  

• Affiche un rendez-vous ou d'autres informations dans une grille de calendrier   Le contrôle Calendar peut afficher des informations spécifiques à certaines journées : liste de tâches à effectuer, de rendez-vous, etc. Cette fonctionnalité vous permet d'afficher des informations enregistrées pour une journée dans une base de données.

Retour au début

Fonctionnalités

Vous pouvez utiliser le contrôle Calendar pour effectuer les opérations suivantes :

• Capturer une intervention de l'utilisateur telle que la sélection d'une date ou d'une plage de dates

• Personnaliser l'apparence du calendrier

• Afficher des informations d'une base de données dans le calendrier

Retour au début

Contexte

Le contrôle Calendar affiche les dates d'un mois, avec un total de six semaines apparaissant simultanément. Il prend en charge plusieurs types de dates qui sont décrits dans le tableau suivant.

Type de date	Description
TodaysDate	Par défaut, cette date est définie pour correspondre à la date du jour sur le serveur. Vous pouvez modifier cette date pour la mettre en conformité avec d'autres paramètres régionaux.
VisibleDate	Cette date détermine le mois affiché par le calendrier. L'utilisateur peut se déplacer de mois en mois dans le calendrier et ainsi modifier la date visible sans affecter celle du jour. Vous pouvez naviguer d'un mois à l'autre en définissant par programme la date visible.
SelectedDate, SelectedDates	Date ou plage de dates sélectionnées par l'utilisateur. Dans le contrôle, l'utilisateur peut sélectionner un jour, une semaine ou un mois, mais ne peut sélectionner que des dates qui se suivent. Vous pouvez également définir la valeur des dates par programme. Dans ce cas, vous pouvez établir des dates sélectionnées non contiguës.

Le contrôle Calendar est basé sur l'objet DateTime et prend par conséquent en charge toute la plage de dates autorisées par cet objet. En fait, vous pouvez afficher n'importe quelle date comprise entre les années 0 et 9999.

Sur une page ASP.NET, le contrôle Calendar est restitué comme un tableau HTML. Toutefois, certaines propriétés définissent différents aspects de mise en forme de cette table. Certaines de ces propriétés ne sont pas prises en charge pleinement dans des navigateurs plus anciens. Par conséquent, toutes les fonctionnalités de mise en forme ne seront pas disponibles dans ces navigateurs.

Activation de la sélection de date

Par défaut, le calendrier permet aux utilisateurs de cliquer sur une date pour la sélectionner. Si vous utilisez le contrôle comme un calendrier en lecture seule, vous pouvez désactiver la fonction de sélection de date.

Si la sélection de date est activée, chaque jour du calendrier contient un contrôle LinkButton qui déclenche un événement lorsqu'un utilisateur clique dessus. Si vous activez la sélection de semaine ou de mois, une colonne de liens est ajoutée à gauche du calendrier pour permettre à l'utilisateur de spécifier la semaine à sélectionner.

Personnalisation de l'apparence du calendrier

Vous pouvez définir les propriétés du calendrier pour modifier ses couleurs, sa taille, sa police et d'autres de ses fonctionnalités visuelles. Il existe plusieurs méthodes, comme il est indiqué dans le tableau suivant.

Méthode de personnalisation	Description
Définition des propriétés	Vous pouvez définir des propriétés pour afficher des lignes de grille, changer le jour affiché comme premier jour de la semaine ou encore modifier l'apparence des noms du jour et du mois.
Définition des propriétés de style étendu	Vous pouvez utiliser les propriétés dérivées de l'objet Style pour définir l'apparence d'éléments particuliers dans le calendrier. Cela inclut la date courante et la barre de titre qui contient les mois et les liens de navigation. Ces propriétés de style sont prises en charge dans les navigateurs qui peuvent utiliser des feuilles de style en cascade. Un jeu réduit de styles d'apparence est pris en charge pour les navigateurs les plus anciens.
Personnalisation du rendu de certaines journées	À mesure qu'il affiche les journées, le contrôle déclenche un événement que vous pouvez gérer pour modifier le flux rendu par le navigateur. Cela permet non seulement de modifier l'apparence des journées, mais aussi d'inclure du contenu personnalisé dans chacune d'elles. Pour plus d'informations, consultez Comment : personnaliser des journées dans un contrôle serveur Web Calendar.

Capture des interactions avec l'utilisateur dans le contrôle serveur Web Calendar

Le contrôle Calendar incrémente l'événement SelectionChanged lorsque l'utilisateur sélectionne une date donnée ou une plage de dates. Il incrémente l'événement VisibleMonthChanged lorsque l'utilisateur affiche un nouveau mois. En créant des méthodes pour ces événements, vous pouvez déterminer quel jour ou quelles dates l'utilisateur a sélectionnés et offrir une réponse appropriée. Une réponse pourrait être par exemple de personnaliser l'affichage de cette date.

Affichage dans le contrôle Calendar d'informations issues d'une base de données

Le calendrier est souvent utilisé pour afficher des informations issues d'une base de données. Par exemple, un calendrier d'événements fait souvent appel à des informations enregistrées dans une base de données.

Le contrôle Calendar ne prend pas directement en charge la liaison de données — autrement dit, vous ne liez pas le calendrier dans son intégralité à une source de données. À la place, vous créez une méthode pour l'événement DayRender du contrôle, qui est déclenché à mesure que s'affiche chaque jour du mois actuel. Dans la gestion de cet événement, vous pouvez extraire des informations de la source de données et les ajouter au flux envoyé au navigateur. Pour plus d'informations, consultez Comment : afficher des dates sélectionnées d'une base de données dans le contrôle Calendar.

Accessibilité

Pour rendre le contrôle Calendar plus accessible aux utilisateurs de périphériques d'aide, celui-ci prend en charge une propriété nommée UseAccessibleHeader. Lorsque cette propriété a la valeur true (paramètre par défaut), les en-têtes de colonnes qui contiennent les noms des jours sont restituées à l'aide d'éléments HTML th.

Retour au début

Exemples de code

• Comment : contrôler la navigation entre les mois dans un contrôle serveur Web Calendar

• Comment : contrôler la sélection de la date par l'utilisateur dans un contrôle serveur Web Calendar

• Comment : personnaliser l'apparence du contrôle serveur Web Calendar

• Comment : personnaliser des journées dans un contrôle serveur Web Calendar

• Comment : mettre en forme des éléments du contrôle serveur Web Calendar à l'aide de styles

• Comment : répondre à la sélection de la date dans un contrôle serveur Web Calendar

• Comment : lire les dates sélectionnées dans le contrôle serveur Web Calendar

• Comment : sélectionner des dates par programme dans un contrôle serveur Web Calendar

• Comment : définir la date actuelle par programme dans un contrôle serveur Web Calendar

• Comment : afficher des dates sélectionnées d'une base de données dans le contrôle Calendar

Retour au début

Référence de classe

Le tableau suivant répertorie les classes relatives au contrôle Calendar.

Membre	Description
Calendar	Classe principale du contrôle.
CalendarDay	Classe qui représente une date dans le contrôle Calendar.
CalendarSelectionMode	Énumération qui représente les modes de sélection de dates dans le contrôle Calendar.

Retour au début

Voir aussi

Tâches

Comment : sélectionner des dates par programme dans un contrôle serveur Web Calendar

Comment : afficher des dates sélectionnées d'une base de données dans le contrôle Calendar

Autres ressources

Utilisation des contrôles serveur Web ASP.NET