Syntaxe déclarative du contrôle serveur Web Calendar
Mise à jour : novembre 2007
Affiche un calendrier mensuel qui permet à l'utilisateur de sélectionner des dates et de se déplacer vers les mois précédents ou suivants.
<asp:Calendar
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DayNameFormat="Full|Short|FirstLetter|FirstTwoLetters|Shortest"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FirstDayOfWeek="Sunday|Monday|Tuesday|Wednesday|Thursday|Friday|
Saturday|Default"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
NextMonthText="string"
NextPrevFormat="CustomText|ShortMonth|FullMonth"
OnDataBinding="DataBinding event handler"
OnDayRender="DayRender event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectionChanged="SelectionChanged event handler"
OnUnload="Unload event handler"
OnVisibleMonthChanged="VisibleMonthChanged event handler"
PrevMonthText="string"
runat="server"
SelectedDate="string"
SelectionMode="None|Day|DayWeek|DayWeekMonth"
SelectMonthText="string"
SelectWeekText="string"
ShowDayHeader="True|False"
ShowGridLines="True|False"
ShowNextPrevMonth="True|False"
ShowTitle="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
TitleFormat="Month|MonthYear"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
VisibleDate="string"
Width="size"
>
<DayHeaderStyle/>
<DayStyle/>
<NextPrevStyle/>
<OtherMonthDayStyle/>
<SelectedDayStyle/>
<SelectorStyle/>
<TitleStyle/>
<TodayDayStyle/>
<WeekendDayStyle/>
</asp:Calendar>
Notes
Le contrôle Calendar sert à afficher un calendrier mensuel qui permet à l'utilisateur de sélectionner des dates et de se déplacer vers les mois précédents ou suivants.
En définissant la propriété SelectionMode, vous pouvez spécifier si l'utilisateur peut sélectionner un seul jour, une semaine ou un mois ou vous pouvez désactiver complètement la sélection de date.
La définition des propriétés de style pour les différentes parties du contrôle permet de personnaliser l'apparence du contrôle Calendar. Le tableau suivant répertorie les différentes propriétés de style du contrôle Calendar.
Objet de style |
Description |
Classe de style |
||
|---|---|---|---|---|
Style de la section du calendrier où apparaissent les noms des jours de la semaine. |
||||
Style des jours dans le mois affiché.
|
||||
Style des sections situées aux extrémités gauche et droite de la barre de titre et où se trouvent les contrôles LinkButton de navigation entre les mois. |
||||
Style des jours du mois précédent et du mois suivant qui apparaissent dans la vue du mois en cours. |
||||
Style de la date sélectionnée.
|
||||
Style de la colonne qui est située à gauche du contrôle Calendar et contient des liens permettant de sélectionner une semaine ou le mois entier. |
||||
Style de la barre de titre située en haut du calendrier et contenant le nom du mois et les liens de navigation entre les mois.
|
||||
Style de la date du jour.
|
||||
Style des jours du week-end.
|
.gif "Remarque")
Remarque :Vous pouvez également contrôler l'apparence du contrôle Calendar en affichant ou masquant certaines parties du contrôle. Le tableau suivant répertorie les éléments du contrôle Calendar qui peuvent être affichés ou masqués.
Propriété |
Description |
|---|---|
Affiche ou masque la section affichant les jours de la semaine. |
|
Affiche ou masque les lignes du quadrillage entre les jours du mois. |
|
Affiche ou masque les contrôles de navigation vers le mois suivant ou vers le mois précédent. |
|
Affiche ou masque la section du titre. |
Bien que la liaison à une source de données ne soit pas prise en charge dans le contrôle Calendar, vous pouvez modifier le contenu et la mise en forme des cellules de date individuelles. Avant que le contrôle Calendar soit affiché sur la page Web, il crée et assemble les composants du contrôle. 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 au moment de sa création en fournissant du code dans le gestionnaire d'événements de l'événement DayRender.
Remarque Le contrôle Calendar restitue du langage JavaScript sur le navigateur client. Le JavaScript 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.
Pour plus d'informations sur les propriétés prises en charge par chaque classe de style, consultez les propriétés des objets de style.
Pour plus d'informations sur les propriétés et événements du contrôle Calendar, consultez la documentation de la classe Calendar.
Exemple
L'exemple suivant illustre un exemple de déclaration d'un contrôle Calendar dans un fichier .aspx. La déclaration comporte un certain nombre de propriétés d'objet de style et établit la méthode Date_Selected comme gestionnaire de l'événement SelectionChanged.
<asp:Calendar id="Calendar2"
OnSelectionChanged="Date_Selected"
SelectionMode="DayWeekMonth"
Font-Name="Verdana"
Font-Size="12px"
NextPrevFormat="ShortMonth"
SelectWeekText="week"
SelectMonthText="month"
runat="server">
<TodayDayStyle Font-Bold="True"/>
<DayHeaderStyle Font-Bold="True"/>
<OtherMonthDayStyle ForeColor="gray"/>
<TitleStyle BackColor="#3366ff"
ForeColor="white"
Font-Bold="True"/>
<SelectedDayStyle BackColor="#ffcc66"
Font-Bold="True"/>
<NextPrevStyle ForeColor="white"
Font-Size="10px"/>
<SelectorStyle BackColor="#99ccff"
ForeColor="navy"
Font-Size="9px"/>
</asp:Calendar>
L'exemple suivant illustre une méthode de gestion d'événements de l'événement SelectionChanged d'un contrôle Calendar. En interrogeant le paramètre SelectedDates du contrôle Calendar, vous pouvez déterminer le nombre de jours sélectionnés et savoir, par conséquent, si l'utilisateur sélectionne un jour, une semaine ou un mois. Les informations relatives à la sélection sont affichées dans un contrôle serveur Web Label.
Sub Date_Selected(sender as Object sender, e As EventArgs)
Select (Calendar1.SelectedDates.Count)
Case 0: 'None
Label1.Text = "No dates are currently selected"
Case 1: 'Day
Label1.Text = "The selected date is " & _
Calendar1.SelectedDate.ToShortDateString
Case 7: 'Week
Label1.Text = "The selection is a week beginning " & _
Calendar1.SelectedDate.ToShortDateString
Case Else: 'Month
Label1.Text = "The selection is a month beginning " & _
Calendar1.SelectedDate.ToShortDateString
End Select
End Sub
protected void Date_Selected(object sender, EventArgs e)
{
switch (Calendar1.SelectedDates.Count)
{
case (0): //None
{
Label1.Text = "No dates are currently selected";
break;
}
case (1): //Day
{
Label1.Text = "The selected date is " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
case (7): //Week
{
Label1.Text = "The selection is a week beginning " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
default: //Month
Label1.Text = "The selection is a month beginning " +
Calendar1.SelectedDate.ToShortDateString();
break;
}
}
Voir aussi
Concepts
Vue d'ensemble du contrôle serveur Web Calendar