Controllo server Web Calendar

Visualizza un calendario, composto da un solo mese, che consente all'utente di selezionare le date e spostarsi al mese successivo o a quello precedente.

<asp:Calendar id="Calendar1"
     CellPadding="pixels"
     CellSpacing="pixels"
     DayNameFormat="FirstLetter|FirstTwoLetters|Full|Short"
     FirstDayOfWeek="Default|Monday|Tuesday|Wednesday|
                    Thursday|Friday|Saturday|Sunday"
     NextMonthText="HTML text"
     NextPrevFormat="ShortMonth|FullMonth|CustomText"
     PrevMonthText="HTML text"
     SelectedDate="date"
     SelectionMode="None|Day|DayWeek|DayWeekMonth"
     SelectMonthText="HTML text"
     SelectWeekText="HTML text"
     ShowDayHeader="True|False"
     ShowGridLines="True|False"
     ShowNextPrevMonth="True|False"
     ShowTitle="True|False"
     TitleFormat="Month|MonthYear"
     TodaysDate="date"
     VisibleDate="date"
     OnDayRender="OnDayRenderMethod"
     OnSelectionChanged="OnSelectionChangedMethod"
     OnVisibleMonthChanged="OnVisibleMonthChangedMethod"
     runat="server">

   <TodayDayStyle property="value"/>
   <DayHeaderStyle property="value"/>
   <DayStyle property="value"/>
   <NextPrevStyle property="value"/>
   <OtherMonthDayStyle property="value"/>
   <SelectedDayStyle property="value"/>
   <SelectorStyle property="value"/>
   <TitleStyle property="value"/>
   <TodayDayStyle property="value"/>
   <WeekendDayStyle property="value"/>

</asp:Calendar>

Osservazioni

Il controllo Calendar viene utilizzato per visualizzare un calendario, composto da un solo mese, che consente all'utente di selezionare le date e spostarsi ai mesi successivi o precedenti.

Se si imposta la proprietà SelectionMode, è possibile specificare se l'utente può selezionare un singolo giorno, una settimana o un mese; altrimenti, è possibile disattivare completamente la selezione della data.

Se si impostano le proprietà di stile per le diverse parti del controllo, si personalizza l'aspetto del controllo Calendar. Nella tabella seguente sono elencate le diverse proprietà di stile per il controllo Calendar.

Oggetto di stile	Descrizione	Classe di stile
DayHeaderStyle	Stile della sezione del calendario in cui sono visualizzati i nomi dei giorni della settimana.	TableItemStyle
DayStyle	Stile dei singoli giorni nel mese visualizzato. Nota   I fine settimana, la data corrente e il giorno selezionato possono avere stili diversi, se si impostano le rispettive proprietà WeekendDayStyle, TodayDayStyle e SelectedDayStyle.	TableItemStyle
NextPrevStyle	Stile delle sezioni a sinistra e a destra della barra del titolo in cui si trovano i controlli LinkButton di spostamento tra i mesi.	TableItemStyle
OtherMonthDayStyle	Stile dei giorni del mese precedente e successivo presenti nella vista del mese corrente.	TableItemStyle
SelectedDayStyle	Stile della data selezionata. Nota   Se la proprietà non è impostata, viene usato lo stile specificato dalla proprietà DayStyle per visualizzare la data selezionata.	TableItemStyle
SelectorStyle	Stile della colonna a sinistra del controllo Calendar che contiene i collegamenti per selezionare una settimana o l'intero mese.	TableItemStyle
TitleStyle	Stile della barra del titolo nella parte superiore del calendario che contiene il nome del mese e i collegamenti per lo spostamento tra i mesi. Nota   Se è impostato lo stile NextPrevStyle, quest'ultimo eseguirà l'override dello stile dei controlli di spostamento al mese precedente e successivo posizionati agli estremi della barra del titolo.	TableItemStyle
TodayDayStyle	Stile della data corrente. Nota   Se la proprietà non è impostata, viene usato lo stile specificato dalla proprietà DayStyle per visualizzare la data corrente.	TableItemStyle
WeekendDayStyle	Stile dei giorni del fine settimana. Nota   Se la proprietà non è impostata, viene usato lo stile specificato dalla proprietà DayStyle per visualizzare le date dei fine settimana.	TableItemStyle

È inoltre possibile controllare l'aspetto del controllo Calendar, visualizzando o nascondendo le diverse parti del controllo. Nella tabella seguente vengono elencate le parti del controllo Calendar che possono essere visualizzate o nascoste.

Proprietà	Descrizione
ShowDayHeader	Mostra o nasconde la sezione in cui sono visualizzati i giorni della settimana.
ShowGridLines	Mostra o nasconde le linee della griglia tra i giorni del mese.
ShowNextPrevMonth	Mostra o nasconde i controlli di spostamento al mese precedente o successivo.
ShowTitle	Mostra o nasconde la sezione del titolo.

Sebbene l'associazione a un'origine dati non sia supportata nel controllo Calendar, è possibile modificare il contenuto e la formattazione delle celle delle singole date. Prima che il controllo Calendar sia visualizzato nella pagina Web, vengono creati e assemblati i componenti di cui è costituito. L'evento DayRender viene generato durante la creazione di ciascuna cella della data nel controllo Calendar. Se si inserisce il codice nel gestore eventi per l'evento DayRender, è possibile controllare i contenuti e la formattazione di una cella della data quando viene creata.

Nota   Il controllo Calendar consente di eseguire il rendering di JavaScript nel browser client. In tale browser deve essere abilitato JavaScript per garantire il corretto funzionamento del controllo. Per ulteriori informazioni sugli script client, vedere Script client nelle pagine Web Form.

Per informazioni sulle proprietà supportate per ciascuna classe di stile, vedere Proprietà dell'oggetto di stile.

Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web Calendar, vedere la documentazione di Classe Calendar.

Esempio

Nell'esempio seguente viene riportata una dichiarazione di un controllo Calendar in un file aspx. La dichiarazione include diverse proprietà di oggetti di stile e imposta il metodo Date_Selected come gestore per l'evento 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>

Nell'esempio seguente viene mostrato un metodo di gestione degli eventi per l'evento SelectionChanged di un controllo Calendar. Se si esegue una query sul parametro SelectedDates del controllo Calendar, è possibile stabilire quanti giorni vengono selezionati e, di conseguenza, se l'utente seleziona un giorno, una settimana o un mese. Le informazioni sulla selezione sono visualizzate in un controllo server 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
[C#]
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;
   }
}

Vedere anche

Controlli server Web | Classe Calendar