Calendar.SelectedDates Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft eine Auflistung von DateTime-Objekten ab, die die ausgewählten Datumsangaben im Calendar-Steuerelement darstellen.

public:
 property System::Web::UI::WebControls::SelectedDatesCollection ^ SelectedDates { System::Web::UI::WebControls::SelectedDatesCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.SelectedDatesCollection SelectedDates { get; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectedDates : System.Web.UI.WebControls.SelectedDatesCollection

Public ReadOnly Property SelectedDates As SelectedDatesCollection

Eigenschaftswert

SelectedDatesCollection

Eine SelectedDatesCollection, die eine Auflistung von DateTime-Objekten enthält, die die ausgewählten Datumsangaben in Calendar darstellen. Der Standardwert ist eine leere SelectedDatesCollection.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SelectedDates Auflistung verwendet wird, um die ausgewählten Datumsangaben für das Calendar Steuerelement zu bestimmen.

<%@ 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(s):" + "<br />";
         for (int i = 0; i <= Calendar1.SelectedDates.Count - 1; i++)
         {
            Label1.Text += Calendar1.SelectedDates[i].ToShortDateString() + "<br />";
         } 
      }

   </script>

</head>     
<body>

   <form id="form1" 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="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(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 id="form1" 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>

Hinweise

Verwenden Sie die SelectedDates Auflistung, um die aktuell ausgewählten Datumsangaben für das Calendar Steuerelement zu bestimmen.

Die SelectedDate Eigenschaft und die SelectedDates Auflistung stehen in engem Zusammenhang. Wenn die SelectionMode -Eigenschaft auf CalendarSelectionMode.Dayfestgelegt ist, ist ein Modus, der nur eine einzelne Datumsauswahl zulässt und SelectedDateSelectedDates[0] denselben Wert aufweist und SelectedDates.Count gleich 1 ist. Wenn die SelectionMode -Eigenschaft auf CalendarSelectionMode.DayWeek oder CalendarSelectionMode.DayWeekMonthfestgelegt ist, gibt es Modi, SelectedDate die mehrere Datumsauswahlen ermöglichen und SelectedDates[0] denselben Wert aufweisen.

Die SelectedDates -Eigenschaft speichert eine Auflistung von System.DateTime -Objekten.

Wenn der Benutzer eine Woche oder einen Monat für das Calendar Steuerelement auswählt, wird das SelectionChanged Ereignis ausgelöst. Die ausgewählten Datumsangaben werden der SelectedDates Auflistung hinzugefügt und ersetzen den vorherigen Inhalt. Der Datumsbereich wird in aufsteigender Reihenfolge nach Datum sortiert. Die SelectedDate -Eigenschaft wird auch aktualisiert, um das erste Datum in der SelectedDates Auflistung zu enthalten.

Sie können die SelectedDates Auflistung auch verwenden, um Datumsangaben im Calendar Steuerelement programmgesteuert auszuwählen. Verwenden Sie die AddMethoden , Remove, Clearund SelectRange , um die ausgewählten Datumsangaben in der SelectedDates Auflistung programmgesteuert zu bearbeiten.

Hinweis

Sowohl die SelectedDate -Eigenschaft als auch die SelectedDates Auflistung werden aktualisiert, bevor das SelectionChanged Ereignis ausgelöst wird. Sie können die Datumsauswahl überschreiben, indem Sie den OnSelectionChanged Ereignishandler verwenden, um die SelectedDates Auflistung manuell festzulegen. Das SelectionChanged Ereignis wird nicht ausgelöst, wenn diese Auflistung programmgesteuert festgelegt ist.

Gilt für:

Freigeben über