Condividi tramite

Cenni preliminari sul controllo server Web Calendar

  • Articolo

Aggiornamento: novembre 2007

Il controllo server Web Calendar può essere utilizzato per visualizzare le date selezionabili in un calendario e i dati associati a date specifiche.

Vengono illustrati i seguenti argomenti:

  • Scenari

  • Funzionalità

  • Informazioni di supporto

  • Esempi di codice

  • Riferimento alle classi

Scenari

È possibile utilizzare il controllo server Web Calendar per effettuare le seguenti operazioni:

  • Visualizzare e selezionare le date   Il controllo visualizza un calendario che consente agli utenti di spostarsi su qualsiasi giorno dell'anno. Se si imposta la proprietà SelectedDate, nel controllo viene evidenziata una data specifica. Gli utenti possono passare alle date desiderate facendo clic su un giorno o spostandosi da un mese all'altro. È possibile configurare il calendario in modo da permettere la selezione di più date, ad esempio un'intera settimana o un intero mese.

    Rappresentazione del controllo Calendar con visualizzazione del mese di ottobre

  • Visualizzare appuntamenti o altre informazioni in una griglia di calendario   Il controllo Calendar consente di visualizzare dettagli specifici per singoli giorni, ad esempio l'elenco delle attività in agenda, gli eventi pianificati o informazioni simili. Con questa funzionalità, è possibile visualizzare le informazioni relative a un giorno contenute in un database.

Torna all'inizio

Funzionalità

È possibile utilizzare il controllo Calendar per effettuare le seguenti operazioni:

  • Acquisire l'interazione dell'utente, ad esempio quando un utente seleziona una data o un intervallo di date.

  • Personalizzare l'aspetto del calendario.

  • Visualizzare le informazioni da un database nel calendario.

Torna all'inizio

Informazioni di supporto

Il controllo Calendar consente di visualizzare le date su base mensile, per un totale di sei settimane visualizzate contemporaneamente. Il controllo supporta diversi tipi di date, descritte nella tabella riportata di seguito.

Tipo di data

Descrizione

TodaysDate

Per impostazione predefinita, la data corrisponde a quella corrente nel server. È tuttavia possibile modificarla per adattarla a impostazioni locali diverse.

VisibleDate

Determina il mese visualizzato sul calendario. L'utente può spostarsi da un mese all'altro sul calendario. Questa operazione cambia la data visibile senza effetti su quella odierna. È possibile spostarsi tra i mesi impostando la data visibile a livello di codice.

SelectedDate, SelectedDates

È la data o l'intervallo di date scelto dall'utente. Nel controllo, l'utente può selezionare un singolo giorno, una settimana o un mese, ma può scegliere solo date contigue. Inoltre, può impostare le date selezionate a livello di codice. In tal caso, è possibile impostare date non contigue.

Il controllo Calendar si basa sull'oggetto DateTime e supporta pertanto l'intervallo di date consentito da tale oggetto. È infatti possibile visualizzare qualsiasi data compresa tra l'anno 0 e il 9999 d.C.

Su una pagina ASP.NET, il controllo Calendar viene visualizzato come una tabella HTML. Di conseguenza, alcune delle proprietà del controllo sono relative a vari aspetti della formattazione delle tabelle. Alcune di queste proprietà non sono completamente supportate in certi browser meno recenti. Non tutte le funzionalità di formattazione saranno pertanto disponibili in tali browser.

Attivazione della selezione della data

Per impostazione predefinita, nel calendario gli utenti possono selezionare una singola data facendo clic su di essa. Se si utilizza il controllo come calendario di sola lettura, è possibile disattivare la funzionalità di selezione della data.

Se la selezione della data è attivata, in ogni giorno del calendario viene incluso un controllo LinkButton che genera un evento quando viene fatto clic su di esso. Se si attiva la selezione della settimana o del mese, viene aggiunta una colonna di collegamenti accanto al calendario per consentire all'utente di specificare la settimana da selezionare.

Personalizzazione dell'aspetto del calendario

È possibile impostare le proprietà del calendario per modificarne i colori, le dimensioni, il testo e le altre funzionalità visive. Questa operazione può essere eseguita in diversi modi, come mostrato nella tabella seguente.

Metodo di personalizzazione

Descrizione

Impostazione delle proprietà

È possibile impostare le proprietà in modo da mostrare le linee della griglia, cambiare il giorno che deve essere visualizzato come primo giorno della settimana e modificare l'aspetto dei nomi dei mesi e dei giorni.

Impostazione delle proprietà di stile esteso

È possibile utilizzare le proprietà derivate dall'oggetto Style per impostare l'aspetto di particolari elementi nel calendario, tra cui la data corrente o la barra del titolo che contiene i collegamenti di spostamento e selezione del mese. Queste proprietà dello stile sono supportate nei browser che possono utilizzare i fogli di stile CSS. Un insieme ridotto di stili dell'aspetto è supportato per i browser precedenti.

Personalizzazione del rendering di singoli giorni

Quando esegue il rendering di singoli giorni, il controllo genera un evento che può essere gestito per modificare il flusso di rendering. Tale comportamento non è solo utile per cambiare l'aspetto dei giorni, ma anche per includere contenuto personalizzato per ciascun giorno. Per informazioni dettagliate, vedere Procedura: personalizzare giorni singoli in un controllo server Web Calendar.

Cattura dell'interazione utente con il controllo server Web Calendar

Il controllo Calendar genera l'evento SelectionChanged quando l'utente seleziona una data singola o un intervallo di date. Genera l'evento VisibleMonthChanged quando l'utente visualizza un mese nuovo. La creazione di metodi per questi eventi consente di determinare quale data o quali date sono state selezionate e di rispondere in modo appropriato. Una risposta potrebbe essere la personalizzazione della visualizzazione della data.

Visualizzazione di informazioni di un database nel controllo Calendar

Uno scenario comune consiste nel visualizzare sul calendario le informazioni di un database. Un calendario di eventi, ad esempio, è in genere basato sulle informazioni archiviate in un database.

Poiché il controllo Calendar non supporta direttamente l'associazione dati, non è possibile associare l'intero calendario a un'origine dati, ma occorre creare un metodo per l'evento DayRender del controllo, che si verifica mentre viene eseguito il rendering di ciascun giorno del mese di calendario corrente. Con il gestore per questo evento, è possibile estrarre informazioni da un'origine dati e aggiungerle al flusso inviato al browser. Per informazioni dettagliate, vedere Procedura: visualizzare nel controllo Calendar date specifiche ottenute da un database.

Accessibilità

Per rendere il controllo Calendar più accessibile agli utenti di dispositivi che assistono i disabili, è possibile utilizzare la proprietà UseAccessibleHeader. Quando in questa proprietà è specificato il valore true, che corrisponde all'impostazione predefinita, il rendering delle intestazioni di colonna contenenti i nomi dei giorni viene eseguito tramite elementi HTML th.

Torna all'inizio

Esempi di codice

Torna all'inizio

Riferimento alle classi

Nella tabella riportata di seguito sono elencate le classi correlate al controllo Calendar.

Membro

Descrizione

Calendar

Classe principale del controllo.

CalendarDay

Classe che rappresenta una data nel controllo Calendar.

CalendarSelectionMode

Enumerazione che rappresenta le modalità di selezione della data disponibili nel controllo Calendar.

Torna all'inizio

Vedere anche

Attività

Procedura: selezionare le date a livello di codice in un controllo server Web Calendar

Procedura: visualizzare nel controllo Calendar date specifiche ottenute da un database

Altre risorse

Utilizzo di controlli server Web ASP.NET