Calendar.SelectedDate 屬性

  • 參考

定義

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

取得或設定選取的日期。

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，表示選取的日期。 預設值為 DateTime.MinValue。

屬性
BindableAttribute

範例

下列程式碼範例示範如何使用 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 這個屬性以程式設計方式設定時，不會引發事件。

適用於

另請參閱