Calendar.SelectedDates 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
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.SelectedDatesCollectionPublic 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 時，只允許單一日期選取的模式， 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當以程式設計方式設定此集合時，不會引發事件。
