Calendar.SelectedDate 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定選取的日期。
public:
property DateTime SelectedDate { DateTime get(); void set(DateTime value); };
[System.ComponentModel.Bindable(true)]
public DateTime SelectedDate { get; set; }
[System.ComponentModel.Bindable(true, System.ComponentModel.BindingDirection.TwoWay)]
public DateTime SelectedDate { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.SelectedDate : DateTime with get, set
[<System.ComponentModel.Bindable(true, System.ComponentModel.BindingDirection.TwoWay)>]
member this.SelectedDate : DateTime with get, set
Public Property SelectedDate As DateTime
屬性值
DateTime,表示選取的日期。 預設值為 DateTime.MinValue。
- 屬性
範例
下列程式碼範例示範如何使用 SelectedDate 屬性來判斷控制項上選取的 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 is " + Calendar1.SelectedDate.ToShortDateString();
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Calendar Example</h3>
Select a date on the Calendar control.<br /><br />
<asp:Calendar ID="Calendar1" runat="server"
SelectionMode="Day"
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 is " & Calendar1.SelectedDate.ToShortDateString()
End Sub 'Selection_Change
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Calendar Example</h3>
Select a date on the Calendar control.<br /><br />
<asp:Calendar ID="Calendar1" runat="server"
SelectionMode="Day"
ShowGridLines="True"
OnSelectionChanged="Selection_Change">
<SelectedDayStyle BackColor="Yellow"
ForeColor="Red">
</SelectedDayStyle>
</asp:Calendar>
<hr /><br />
<asp:Label id="Label1" runat="server" />
</form>
</body>
</html>
備註
SelectedDate使用 屬性來判斷控制項上選取的 Calendar 日期。
屬性 SelectedDate 和 SelectedDates 集合緊密相關。
SelectionMode當 屬性設定為 CalendarSelectionMode.Day
時,只允許單一日期選取的模式, SelectedDate 且 SelectedDates[0]
具有相同的值和 SelectedDates.Count
等於 1。
SelectionMode當 屬性設定為 CalendarSelectionMode.DayWeek
或 CalendarSelectionMode.DayWeekMonth
時,允許多個日期選取的模式, SelectedDate 且 SelectedDates[0]
具有相同的值。
屬性 SelectedDate 是使用 System.DateTime 物件來設定。
當使用者選取控制項上的 Calendar 日期時,就會 SelectionChanged 引發 事件。 屬性 SelectedDate 會更新為選取的日期。 集合 SelectedDates 也會更新為只包含這個日期。
注意
SelectedDate屬性和 SelectedDates 集合都會在引發事件之前 SelectionChanged 更新。 您可以使用事件處理常式來手動設定 SelectedDate 屬性,以覆寫日期選取 OnSelectionChanged 範圍。 當 SelectionChanged 這個屬性以程式設計方式設定時,不會引發事件。