Calendar.SelectedDates 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得表示 DateTime 控制項中所選取日期的 Calendar 物件的集合。

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

SelectedDatesCollection，包含表示 DateTime 上所選取日期之 Calendar 物件的集合。 預設值是空的 SelectedDatesCollection。

屬性
BrowsableAttribute

範例

下列程式碼範例示範如何使用 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 時，只允許單一日期選取的模式， SelectedDate 且值相同且 SelectedDates[0]SelectedDates.Count 等於 1。 SelectionMode當 屬性設定為 CalendarSelectionMode.DayWeek 或 CalendarSelectionMode.DayWeekMonth 時，允許多個日期選取的模式， SelectedDate 且 SelectedDates[0] 具有相同的值。

屬性 SelectedDates 會儲存 物件的集合 System.DateTime 。

當使用者在控制項上選取一周或一個月時 Calendar ， SelectionChanged 就會引發 事件。 選取的日期會新增至 SelectedDates 集合，取代先前的內容。 日期的範圍會依日期的遞增順序排序。 屬性 SelectedDate 也會更新為包含集合中的 SelectedDates 第一個日期。

您也可以使用 SelectedDates 集合，以程式設計方式選取 控制項上的 Calendar 日期。 Add使用 、 RemoveClear 和 SelectRange 方法，以程式設計方式操作集合中選取的 SelectedDates 日期。

注意

SelectedDate在引發 事件之前 SelectionChanged ，屬性和 SelectedDates 集合都會更新。 您可以使用事件處理常式手動設定 SelectedDates 集合來覆寫日期選取 OnSelectionChanged 範圍。 SelectionChanged當以程式設計方式設定此集合時，不會引發事件。

適用於

另請參閱