Calendar.SelectedDate Property
Gets or sets the selected date.
[Visual Basic] Public Property SelectedDate As DateTime [C#] public DateTime SelectedDate {get; set;} [C++] public: __property DateTime get_SelectedDate(); public: __property void set_SelectedDate(DateTime); [JScript] public function get SelectedDate() : DateTime; public function set SelectedDate(DateTime);
Property Value
A System.DateTime object that represents the selected date. The default value is DateTime.MinValue.
Remarks
Use the SelectedDate property to determine the selected date on the Calendar control.
The SelectedDate property and the SelectedDates collection are closely related. When 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. When 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.
The SelectedDate property is set using a System.DateTime object.
When the user selects a date on the Calendar control, the SelectionChanged event is raised. The SelectedDate property is updated to the selected date. The SelectedDates collection is also updated to contain just this date.
Note Both the SelectedDate property and the SelectedDates collection are updated before the SelectionChanged event is raised. You can override the date selection by using the OnSelectionChanged event handler to manually set the SelectedDate property. The SelectionChanged event does not get raised when this property is programmatically set.
Example
[Visual Basic, C#, JScript] The following example demonstrates how to use the SelectedDate property to determine the selected date on the Calendar control.
[Visual Basic] <%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <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 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> [C#] <%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <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 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> [JScript] <%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> <script language="JScript" runat="server"> function Selection_Change(sender : Object, e : EventArgs) { Label1.Text = "The selected date is " + Calendar1.SelectedDate.ToShortDateString(); } </script> </head> <body> <form 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>
[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family
See Also
Calendar Class | Calendar Members | System.Web.UI.WebControls Namespace | System.DateTime | SelectedDates | SelectionMode | CalendarSelectionMode | SelectionChanged | OnSelectionChanged