Calendar.SelectedDate Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft das ausgewählte Datum ab oder legt dieses fest.

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

Eigenschaftswert

DateTime

Ein DateTime-Objekt, das das ausgewählte Datum darstellt. Der Standardwert ist DateTime.MinValue.

Attribute
BindableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die SelectedDate -Eigenschaft verwenden, um das ausgewählte Datum 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 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>

Hinweise

Verwenden Sie die SelectedDate -Eigenschaft, um das ausgewählte Datum 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 SelectedDate -Eigenschaft wird mithilfe eines System.DateTime -Objekts festgelegt.

Wenn der Benutzer ein Datum für das Calendar Steuerelement auswählt, wird das SelectionChanged Ereignis ausgelöst. Die SelectedDate -Eigenschaft wird auf das ausgewählte Datum aktualisiert. Die SelectedDates Auflistung wird auch aktualisiert, um nur dieses Datum zu enthalten.

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 SelectedDate Eigenschaft manuell festzulegen. Das SelectionChanged Ereignis wird nicht ausgelöst, wenn diese Eigenschaft programmgesteuert festgelegt ist.

Gilt für:

Weitere Informationen