4.5.14 Элемент управления Calendar (Календарь)

Серверный элемент управления Calendar в ASP.NET 2.0, свойства SelectedDay и SelectionMode

Этот элемент управления, как понятно из названия, предназначен для отображения информации о датах и для получения о пользователя информации об одной дате или диапазоне дат.

Этому элементу управления соответствует достаточно сложный код HTML (примерно 8 Кбайт для одного элемента управления Calendar). Все представленные даты в календаре — на самом деле уже знакомые нам элементы управления LinkButton.

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

• SelectedDate и SelectedDates — самые важные свойства. Они позволяют получить информацию о том, какую дату (или диапазон дат) выбрал пользователь. Конечно, вы можете настроить значения для этих свойств и программным образом (например, чтобы предложить пользователю значения по умолчанию). Свойство SelectedDate используется, когда для свойства SelectionMode используется значение Day (по умолчанию), то есть можно выбрать только один день. В остальных случаях используется свойство SelectedDates, возвращающее массив дат (первое значение массива будет соответствовать SelectedDate).

Если вам нужно выбрать диапазон дат (с такого-то по такое число), то, возможно, наилучшим вариантом будет воспользоваться двумя элементами управления Calendar — одним для даты начала, а другим — для даты завершения.

• SelectionMode — как уже говорилось, это свойство определяет, что именно сможет выбирать пользователь в календаре. Для него предусмотрены следующие значения:
• Day (по умолчанию) — можно выбирать один день;
• DayWeek — можно выбирать день или неделю;
• DayWeekMonth — можно выбирать день, неделю или месяц;
• None — пользователь не сможет ничего выбирать.
• TodaysDate — при помощи этого свойства можно получить или настроить текущую дату. По умолчанию, конечно, текущая дата берется из операционной системы. Обычно изменять ее для календаря приходится только в ситуации, когда ваше Web-приложение учитывает часовой пояс, в котором находится пользователь. Настроить свой собственный вариант отображения текущей даты можно при помощи свойства TodayDayStyle (по умолчанию текущая дата никак не выделена);
• VisibleDate — определяет, какой именно месяц будет изначально показан на календаре. По умолчанию, конечно, показывается текущий месяц (точнее, месяц, к которому относится значение свойства TodaysDate);

Остальные многочисленные свойства этого объекта относятся к его оформлению.

Для этого элемента управления предусмотрено два главных события:

·        SelectionChanged — возникает, когда пользователь выбирает день (или неделю, или месяц);

·        VisibleMonthChanged — возникает, когда пользователь переходит к другому месяцу.

Получить учебные материалы по этому курсу