Calendar.SelectedDates Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
public:
property System::Web::UI::WebControls::SelectedDatesCollection ^ SelectedDates { System::Web::UI::WebControls::SelectedDatesCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.SelectedDatesCollection SelectedDates { get; }
[<System.ComponentModel.Browsable(false)>]
member this.SelectedDates : System.Web.UI.WebControls.SelectedDatesCollection
Public ReadOnly Property SelectedDates As SelectedDatesCollection
Значение свойства
Класс SelectedDatesCollection, содержащий коллекцию объектов DateTime, представляющих выделенные даты в объекте Calendar. Значение по умолчанию — пустой объект SelectedDatesCollection.
- Атрибуты
Примеры
В следующем примере кода показано, как использовать коллекцию SelectedDates для определения выбранных дат в элементе Calendar управления .
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Calendar Example</title>
<script language="C#" runat="server">
void Selection_Change(Object sender, EventArgs e)
{
Label1.Text = "The selected date(s):" + "<br />";
for (int i = 0; i <= Calendar1.SelectedDates.Count - 1; i++)
{
Label1.Text += Calendar1.SelectedDates[i].ToShortDateString() + "<br />";
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Calendar Example</h3>
Select date(s) on the Calendar control.<br /><br />
<asp:Calendar ID="Calendar1" runat="server"
SelectionMode="DayWeekMonth"
ShowGridLines="True"
OnSelectionChanged="Selection_Change">
<SelectedDayStyle BackColor="Yellow"
ForeColor="Red">
</SelectedDayStyle>
</asp:Calendar>
<hr /><br />
<asp:Label id="Label1" runat="server" />
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Calendar Example</title>
<script language="VB" runat="server">
Sub Selection_Change(sender As Object, e As EventArgs)
Label1.Text = "The selected date(s):" & ChrW(60) & "br" & ChrW(62)
Dim i As Integer
For i = 0 To Calendar1.SelectedDates.Count - 1
Label1.Text &= Calendar1.SelectedDates(i).ToShortDateString() & ChrW(60) & "br" & ChrW(62)
Next i
End Sub 'Selection_Change
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Calendar Example</h3>
Select date(s) on the Calendar control.<br /><br />
<asp:Calendar ID="Calendar1" runat="server"
SelectionMode="DayWeekMonth"
ShowGridLines="True"
OnSelectionChanged="Selection_Change">
<SelectedDayStyle BackColor="Yellow"
ForeColor="Red">
</SelectedDayStyle>
</asp:Calendar>
<hr /><br />
<asp:Label id="Label1" runat="server" />
</form>
</body>
</html>
Комментарии
Используйте коллекцию SelectedDates , чтобы определить выбранные в данный момент даты в элементе Calendar управления .
Свойство SelectedDate и SelectedDates коллекция тесно связаны между собой. Если свойству SelectionMode присвоено значение CalendarSelectionMode.Day
, режим, который допускает выбор только одной даты и SelectedDateSelectedDates[0]
имеет одинаковое значение и SelectedDates.Count
равно 1. Если свойству SelectionMode присвоено значение CalendarSelectionMode.DayWeek
или CalendarSelectionMode.DayWeekMonth
, режимы SelectedDate , которые позволяют выбирать несколько дат и SelectedDates[0]
имеют одинаковое значение.
Свойство SelectedDates хранит коллекцию System.DateTime объектов .
Когда пользователь выбирает неделю или месяц для Calendar элемента управления, SelectionChanged возникает событие . Выбранные даты добавляются в коллекцию SelectedDates , заменяя предыдущее содержимое. Диапазон дат сортируется по возрастанию по дате. Свойство SelectedDate также обновляется, чтобы оно содержало первую дату в SelectedDates коллекции.
Вы также можете использовать коллекцию SelectedDates для программного выбора дат в элементе Calendar управления . Используйте методы Add, Remove, Clearи SelectRange для программного управления выбранными датами в SelectedDates коллекции.
Примечание
SelectedDate Свойство и SelectedDates коллекция обновляются до SelectionChanged возникновения события. Вы можете переопределить выбор даты с помощью обработчика OnSelectionChanged событий, чтобы вручную задать коллекцию SelectedDates . Событие SelectionChanged не возникает при программной настройке этой коллекции.