Calendar.SelectedDate-Eigenschaft
Ruft das ausgewählte Datum ab oder legt dieses fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<BindableAttribute(True, BindingDirection.TwoWay)> _
Public Property SelectedDate As DateTime
'Usage
Dim instance As Calendar
Dim value As DateTime
value = instance.SelectedDate
instance.SelectedDate = value
[BindableAttribute(true, BindingDirection.TwoWay)]
public DateTime SelectedDate { get; set; }
[BindableAttribute(true, BindingDirection::TwoWay)]
public:
property DateTime SelectedDate {
DateTime get ();
void set (DateTime value);
}
/** @property */
public DateTime get_SelectedDate ()
/** @property */
public void set_SelectedDate (DateTime value)
public function get SelectedDate () : DateTime
public function set SelectedDate (value : DateTime)
Eigenschaftenwert
Ein System.DateTime-Objekt, das das ausgewählte Datum darstellt. Der Standardwert ist DateTime.MinValue.
Hinweise
Mit der SelectedDate-Eigenschaft bestimmen Sie das im Calendar-Steuerelement ausgewählte Datum.
Die SelectedDate-Eigenschaft und die SelectedDates-Auflistung hängen eng zusammen. Wenn die SelectionMode-Eigenschaft auf CalendarSelectionMode.Day festgelegt ist (ein Modus, der nur eine einzelne Datenauswahl ermöglicht), weisen SelectedDate und SelectedDates[0] denselben Wert auf, und SelectedDates.Count ist gleich 1. Wenn die SelectionMode-Eigenschaft auf CalendarSelectionMode.DayWeek oder CalendarSelectionMode.DayWeekMonth festgelegt ist (Modi, die mehrere Datenauswahlmöglichkeiten bieten), haben SelectedDate und SelectedDates[0] denselben Wert.
Die SelectedDate-Eigenschaft wird mit einem System.DateTime-Objekt festgelegt.
Beim Auswählen eines Datums im Calendar-Steuerelement wird das SelectionChanged-Ereignis ausgelöst. Die SelectedDate-Eigenschaft wird auf das ausgewählte Datum aktualisiert. Die SelectedDates-Auflistung wird außerdem so aktualisiert, dass sie nur dieses Datum enthält.
Hinweis
Sowohl die SelectedDate-Eigenschaft als auch die SelectedDates-Auflistung werden vor dem Auslösen des SelectionChanged-Ereignisses aktualisiert. Sie können die Datumsauswahl überschreiben, indem Sie die SelectedDate-Eigenschaft mit dem OnSelectionChanged-Ereignishandler manuell festlegen. Das SelectionChanged-Ereignis wird nicht ausgelöst, wenn diese Eigenschaft programmgesteuert festgelegt wird.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit der SelectedDate-Eigenschaft das ausgewählte Datum im Calendar-Steuerelement bestimmt wird.
<%@ 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>
<%@ 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>
<%@ 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>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Calendar-Klasse
Calendar-Member
System.Web.UI.WebControls-Namespace
System.DateTime
SelectedDates
SelectionMode
CalendarSelectionMode
SelectionChanged
OnSelectionChanged