Calendar.SelectedDates-Eigenschaft
Ruft eine Auflistung von System.DateTime-Objekten ab, die die ausgewählten Datumsangaben im Calendar-Steuerelement darstellen.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public ReadOnly Property SelectedDates As SelectedDatesCollection
'Usage
Dim instance As Calendar
Dim value As SelectedDatesCollection
value = instance.SelectedDates
public SelectedDatesCollection SelectedDates { get; }
public:
property SelectedDatesCollection^ SelectedDates {
SelectedDatesCollection^ get ();
}
/** @property */
public SelectedDatesCollection get_SelectedDates ()
public function get SelectedDates () : SelectedDatesCollection
Eigenschaftenwert
Eine SelectedDatesCollection, die eine Auflistung von System.DateTime-Objekten enthält, die die ausgewählten Datumsangaben in Calendar darstellen. Der Standardwert ist eine leere SelectedDatesCollection.
Hinweise
Bestimmen Sie mit der SelectedDates-Auflistung die gegenwärtig ausgewählten Datumsangaben im Calendar-Steuerelement.
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.
In der SelectedDates-Eigenschaft ist eine Auflistung von System.DateTime-Objekten gespeichert.
Beim Auswählen einer Woche oder eines Monats im Calendar-Steuerelement wird das SelectionChanged-Ereignis ausgelöst. Die ausgewählten Datumsangaben werden der SelectedDates-Auflistung hinzugefügt und ersetzen dabei den bisherigen Inhalt. Die Datumsbereiche werden in aufsteigender Reihenfolge nach dem Datum sortiert. Die SelectedDate-Eigenschaft wird ebenfalls so aktualisiert, dass sie das erste Datum in der SelectedDates-Auflistung enthält.
Sie können mit der SelectedDates-Auflistung auch programmgesteuert Datumsangaben im Calendar-Steuerelement auswählen. Bearbeiten Sie mit den Methoden Add, Remove, Clear und SelectRange die ausgewählten Datumsangaben in der SelectedDates-Auflistung programmgesteuert.
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 SelectedDates-Auflistung mit dem OnSelectionChanged-Ereignishandler manuell festlegen. Das SelectionChanged-Ereignis wird nicht ausgelöst, wenn diese Auflistung programmgesteuert festgelegt wird.
| Thema | Position |
|---|---|
| Gewusst wie: Steuern der Monatsnavigation in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Lesen ausgewählter Datumsangaben in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Steuern der Monatsnavigation in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Lesen ausgewählter Datumsangaben in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Steuern der Monatsnavigation in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Lesen ausgewählter Datumsangaben in einem Calendar-Webserversteuerelement | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der SelectedDates-Auflistung die ausgewählten Datumsangaben im Calendar-Steuerelement bestimmt werden.
<%@ 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(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 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="C#" AutoEventWireup="True" %>
<html>
<head>
<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 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="JScript" AutoEventWireup="True" %>
<html>
<head>
<script language="JScript" runat="server">
function Selection_Change(sender : Object, e : EventArgs)
{
Label1.Text = "The selected date(s):" + "<br>";
for (var i : int = 0; i <= Calendar1.SelectedDates.Count - 1; i++)
{
Label1.Text += Calendar1.SelectedDates[i].ToShortDateString() + "<br>";
}
}
</script>
</head>
<body>
<form 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>
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
Calendar.SelectedDate-Eigenschaft
SelectionMode
CalendarSelectionMode
SelectionChanged
OnSelectionChanged