Calendar.SelectedDates Свойство

Определение

Получает коллекцию объектов DateTime, представляющих выбранные даты в элементе управления Calendar.Gets a collection of DateTime objects that represent the selected dates on the Calendar control.

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; }
member this.SelectedDates : System.Web.UI.WebControls.SelectedDatesCollection
Public ReadOnly Property SelectedDates As SelectedDatesCollection

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

Класс SelectedDatesCollection, содержащий коллекцию объектов DateTime, представляющих выделенные даты в объекте Calendar.A SelectedDatesCollection that contains a collection of DateTime objects representing the selected dates on the Calendar. Значение по умолчанию — пустой объект SelectedDatesCollection.The default value is an empty SelectedDatesCollection.

Атрибуты

Примеры

В следующем примере кода показано, как использовать SelectedDates коллекцию для определения выбранных дат Calendar в элементе управления.The following code example demonstrates how to use the SelectedDates collection to determine the selected dates on the Calendar control.

<%@ 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>

Комментарии

Используйте коллекцию для определения выбранных в данный момент дат Calendar элемента управления. SelectedDatesUse the SelectedDates collection to determine the currently selected dates on the Calendar control.

SelectedDate СвойствоSelectedDates и коллекция тесно связаны.The SelectedDate property and the SelectedDates collection are closely related. CalendarSelectionMode.Day SelectedDate SelectedDates[0] Если свойство имеет значение, то режим, который допускает выбор только одной даты и имеет одно и то же значение и SelectedDates.Count равен 1. SelectionModeWhen the SelectionMode property is set to CalendarSelectionMode.Day, a mode that allows only a single date selection, SelectedDate and SelectedDates[0] have the same value and SelectedDates.Count equals 1. CalendarSelectionMode.DayWeek CalendarSelectionMode.DayWeekMonthЕсли свойство имеет значение или SelectedDates[0] ,торежимы,которыедопускаютвыборнесколькихдатиимеютодноитожезначение.SelectedDate SelectionModeWhen the SelectionMode property is set to CalendarSelectionMode.DayWeek or CalendarSelectionMode.DayWeekMonth, modes that allows multiple date selections, SelectedDate and SelectedDates[0] have the same value.

SelectedDates Свойство хранитSystem.DateTime коллекцию объектов.The SelectedDates property stores a collection of System.DateTime objects.

Когда пользователь выбирает неделю или месяц в Calendar элементе управления SelectionChanged , возникает событие.When the user selects a week or month on the Calendar control, the SelectionChanged event is raised. Выбранные даты добавляются в SelectedDates коллекцию, заменяя предыдущее содержимое.The selected dates are added to the SelectedDates collection, replacing the previous contents. Диапазон дат сортируется в порядке возрастания по дате.The range of dates are sorted in ascending order by date. Свойство также обновляется, чтобы содержать первую дату SelectedDates в коллекции. SelectedDateThe SelectedDate property is also updated to contain the first date in the SelectedDates collection.

Можно также использовать SelectedDates коллекцию для программного выбора дат Calendar в элементе управления.You can also use the SelectedDates collection to programmatically select dates on the Calendar control. RemoveИспользуйте методы Add,, Clear SelectedDates и дляпрограммногоуправлениявыбраннымидатамивколлекцииSelectRange .Use the Add, Remove, Clear, and SelectRange methods to programmatically manipulate the selected dates in the SelectedDates collection.

Примечание

Как свойство, так SelectionChanged и коллекцияобновляютсядовозникновениясобытия.SelectedDates SelectedDateBoth the SelectedDate property and the SelectedDates collection are updated before the SelectionChanged event is raised. Можно переопределить выбор даты с помощью OnSelectionChanged обработчика событий, чтобы вручную SelectedDates задать коллекцию.You can override the date selection by using the OnSelectionChanged event handler to manually set the SelectedDates collection. SelectionChanged Событие не возникает, если эта коллекция задана программно.The SelectionChanged event is not raised when this collection is programmatically set.

Применяется к

Дополнительно