Общие сведения о серверном веб-элементе управления Calendar

Visual Studio 2010

Обновлен: Ноябрь 2007

Серверный веб-элемент управления Calendar можно использовать для отображения выбираемых в календаре дат и связанных с определенными датами данных.

В этом разделе рассматриваются следующие темы:

Серверный веб-элемент управления Calendar можно использовать для выполнения следующих функций:

  • Отображение и выбор дат   Этот элемент управления используется для отображения календаря, с помощью которого можно перейти к любому дню в любом году. Настройка свойства SelectedDate приводит к выделению определенной даты в элементе управления. При необходимости можно перейти к произвольной дате, щелкнув день или перемещаясь от месяца к месяцу. Можно настроить календарь таким образом, чтобы пользователи могли выбирать несколько дат, а также целую неделю или месяц.

    Представление элемента управления Calendar, в котором отображается месяц октябрь
    Календарь Visual Studio WebApplication
  • Отображение назначенных встреч и других сведений в сетке календаря   Элемент управления Calendar можно использовать для отображения определенных сведений по отдельным дням, таких как список дел, график событий или подобные сведения. Эта возможность позволяет отображать сведения о дне из базы данных.

К началу

Можно использовать элемент управления Calendar для выполнения следующих задач.

  • Перехват действий пользователя, таких как выбор даты или диапазона дат.

  • Настройка внешнего вида календаря.

  • Отображение сведений из базы данных в календаре.

К началу

Элемент управления Calendar позволяет отображать даты одного месяца, при этом одновременно отображаются шесть недель. Элемент управления поддерживает несколько типов дат, описанных в следующей таблице.

Тип даты

Описание

TodaysDate

По умолчанию это значение соответствует текущей дате на сервере. Однако ее можно изменить, чтобы дата отображалась правильно для других региональных настроек.

VisibleDate

Эта дата определяет, какой месяц отображается в календаре. В календаре можно перемещаться от месяца к месяцу и менять отображаемую дату, не меняя при этом текущую. Можно перемещаться между месяцами, настроив отображаемую дату программным образом.

SelectedDate, SelectedDates

Это дата или диапазон дат, выбранные пользователем. В этом элементе управления можно выбрать только один день, одну неделю или один месяц, но при этом выбираются только следующие подряд даты. Кроме того, выделенные даты можно задать программными средствами. В этом случае можно указать выделенные даты не подряд.

Элемент управления Calendar основан на объекте DateTime и, следовательно, поддерживает весь диапазон дат, разрешенных этим объектом. Фактически можно отображать даты между 0 и 9999 годами н. э.

На странице ASP.NET элемент управления Calendar отображается как таблица HTML. Следовательно, ряд свойств этого элемента управления относится к различным аспектам форматирования таблицы. Ряд этих свойств в некоторых старых обозревателях поддерживаются не полностью. Следовательно, в этих обозревателях доступны не все возможности форматирования.

Включение выбора даты

По умолчанию этот календарь позволяет выбрать отдельную дату, щелкнув по ней. Когда этот элемент управления используется как календарь только для чтения, можно отключить возможность выбора дат.

При включении возможности выбора даты каждый день календаря содержит элемент управления LinkButton, при щелчке по которому возникает событие. При включении выбора недели или месяца сбоку от календаря добавляется столбец ссылок, позволяющих выбрать неделю.

Настройка внешнего вида календаря

Можно задать свойства календаря, определяющие цвета, размер, текст и другие визуальные характеристики календаря. Это можно сделать несколькими способами, описанными в следующей таблице.

Метод настройки

Описание

Задание свойств

Можно задать свойства отображения линий сетки, изменения дня, отображаемого в качестве первого дня недели, и для изменения внешнего вида названий месяца или дня недели.

Задание расширенных свойств стиля

Можно использовать свойства, полученные от объекта Style, чтобы задать внешний вид отдельных элементов календаря. Сюда относятся текущая дата или заголовок, содержащий месяц и ссылки для перехода. Эти свойства стиля поддерживаются в обозревателях, в которых можно использовать каскадные таблицы стилей. Сокращенный набор стилей внешнего вида поддерживается для более ранних версий обозревателей.

Настройка отображения отдельных дней

При отображении отдельных дней элемент управления создает событие, которое можно обработать для изменения воспроизводимого потока. Это используется не только для изменения внешнего вида дней, но и для включения в каждый день пользовательского содержимого. Дополнительные сведения см. в разделе Практическое руководство. Настройка отдельных дней в серверном веб-элементе управления Calendar.

Перехват действий пользователя с серверным веб-элементом управления Calendar

Элемент управления Calendar вызывает событие SelectionChanged, когда пользователь выбирает отдельную дату или диапазон дат. Он вызывает событие VisibleMonthChanged при отображении нового месяца. Можно определить, какую дату или даты выбрал пользователь, и отреагировать соответственно, создав методы для этих событий. Одна из возможных реакций — настройка отображения этой даты.

Отображение сведений из базы данных в элементе управления Calendar

Очень часто необходимо отобразить в календаре сведения из базы данных. Например, календарь событий часто основывается на сведениях, хранящихся в базе данных.

Элемент управления Calendar непосредственно не поддерживает привязку данных, то есть календарь не привязан к источнику данных как единое целое. Вместо этого создается метод для события DayRender этого элемента управления, вызываемого при отображении каждого дня в текущем календарном месяце. В обработчике для этого события можно извлечь сведения из источника данных и добавить их к потоку, отображаемому в обозревателе. Дополнительные сведения см. в разделе Практическое руководство. Отображение выбранных дат из базы данных в элементе управления Calendar.

Специальные возможности

Для повышения доступности элемента управления Calendar для пользователей вспомогательных устройств, он поддерживает свойство с именем UseAccessibleHeader. Если этому свойству присвоено значение true (значение по умолчанию), то заголовки столбцов, содержащие названия дней, отображаются с использованием HTML-элементов th.

К началу

К началу

В следующей таблице перечислены классы, связанные с элементом управления Calendar.

Член

Описание

Calendar

Основной класс элемента управления.

CalendarDay

Класс, представляющий дату в элементе управления Calendar.

CalendarSelectionMode

Перечисление, представляющее режимы выбора даты, доступные в элементе управления Calendar.

К началу

Показ: