MonthChangedEventArgs.NewDate Eigenschaft

  • Referenz

Definition

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

Ruft das Datum ab, das den Monat angibt, der gegenwärtig im Calendar-Steuerelement angezeigt wird.

public:
 property DateTime NewDate { DateTime get(); };
public DateTime NewDate { get; }
member this.NewDate : DateTime
Public ReadOnly Property NewDate As DateTime

Eigenschaftswert

DateTime

Das Datum, das den Monat angibt, der gegenwärtig von Calendar angezeigt wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Monate der NewDate Eigenschaft und der PreviousDate Eigenschaft vergleichen, um festzustellen, ob das Calendar Steuerelement einen Monat oder einen Monat rückwärts verschoben hat.

<%@ 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 runat="server">
    <title> Calendar VisibleMonthChanged Example </title>
<script runat="server">

      void MonthChange(Object sender, MonthChangedEventArgs e) 
      {

         if (e.NewDate.Month > e.PreviousDate.Month)
         { 
            Message.Text = "You moved forward one month.";
         }
         else
         {
            Message.Text = "You moved backwards one month.";
         }

      }
         
   </script>
 
</head>
 
<body>
 
   <form id="form1" runat="server">

      <h3> Calendar VisibleMonthChanged Example </h3>
       
      Select a different month on the calendar. 
      <br /><br />
 
      <asp:Calendar id="Calendar1" runat="server"
           OnVisibleMonthChanged="MonthChange">

         <WeekendDayStyle BackColor="gray">
         </WeekendDayStyle>

      </asp:Calendar>

      <hr /> 

      <table border="1">

         <tr style="background-color:Silver">

            <th>

               Month navigation direction

            </th>
         </tr>

         <tr>

            <td>
           
               <asp:Label id="Message" 
                    Text="Starting month." 
                    runat="server"/>

            </td>

         </tr>

      </table>
                   
   </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 runat="server">
    <title> Calendar VisibleMonthChanged Example </title>
<script runat="server">

      Sub MonthChange(sender As Object, e As MonthChangedEventArgs) 

         If e.NewDate.Month > e.PreviousDate.Month Then
         
            Message.Text = "You moved forward one month."
         
         Else
         
            Message.Text = "You moved backwards one month."
       
         End If

      End Sub
         
   </script>
 
</head>
 
<body>
 
   <form id="form1" runat="server">

      <h3> Calendar VisibleMonthChanged Example </h3>
       
      Select a different month on the calendar. 
      <br /><br />
 
      <asp:Calendar id="Calendar1" runat="server"
           OnVisibleMonthChanged="MonthChange">

         <WeekendDayStyle BackColor="gray">
         </WeekendDayStyle>

      </asp:Calendar>

      <hr /> 

      <table border="1">

         <tr style="background-color:Silver">

            <th>

               Month navigation direction

            </th>
         </tr>

         <tr>

            <td>
           
               <asp:Label id="Message" 
                    Text="Starting Month." 
                    runat="server"/>

            </td>

         </tr>

      </table>
                   
   </form>
         
</body>

</html>

Hinweise

Verwenden Sie diese Eigenschaft, um den vom Steuerelement angezeigten Monat Calendar zu erhalten und den aktuell angezeigten Monat mit einem anderen Monat zu vergleichen. Sie können beispielsweise diese Eigenschaft verwenden, um die Anzahl der Monate bis oder seit einem bestimmten Datum zu berechnen.

Dieses Datum ist normalerweise das erste Datum des aktuell angezeigten Monats; Es kann jedoch programmgesteuert in jedes Datum innerhalb des Monats geändert werden.

Die VisibleDate Eigenschaft kann dieser Eigenschaft programmgesteuert zugewiesen werden, um die Monatsänderung außer Kraft zu setzen, wenn der Benutzer auf die Navigationssteuerelemente für das Calendar Steuerelement klickt.

Gilt für

Siehe auch