MonthChangedEventArgs.NewDate-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public ReadOnly Property NewDate As DateTime
'Usage
Dim instance As MonthChangedEventArgs
Dim value As DateTime

value = instance.NewDate

public DateTime NewDate { get; }

public:
property DateTime NewDate {
    DateTime get ();
}

/** @property */
public DateTime get_NewDate ()

public function get NewDate () : DateTime

Eigenschaftenwert

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

Hinweise

Mit dieser Eigenschaft können Sie den gegenwärtig vom Calendar-Steuerelement angezeigten Monat abrufen und diesen mit einem anderen Monat vergleichen. Mithilfe dieser Eigenschaft können Sie z. B. die Anzahl der Monate bis zu einem bestimmten Datum bzw. ab diesem Datum berechnen.

Bei diesem Datum handelt es sich normalerweise um den Ersten des gegenwärtig angezeigten Monats. Es kann jedoch programmgesteuert in ein beliebiges anderes Datum dieses Monats geändert werden.

Die VisibleDate-Eigenschaft kann dieser Eigenschaft programmgesteuert zugewiesen werden, um die Monatsänderung zu überschreiben, sobald der Benutzer auf die Navigationssteuerelemente für das Calendar-Steuerelement klickt.

Thema	Position
Gewusst wie: Steuern der Monatsnavigation 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: Steuern der Monatsnavigation in einem Calendar-Webserversteuerelement	Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die Monate der NewDate-Eigenschaft und der PreviousDate-Eigenschaft verglichen werden, um zu bestimmen, ob mit dem Calendar-Steuerelement ein Monat vorwärts oder rückwärts navigiert wurde.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>

<head>

   <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 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 bgcolor="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="C#" AutoEventWireup="True" %>

<html>

<head>

   <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 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 bgcolor="Silver">

            <th>

               Month navigation direction

            </th>
         </tr>

         <tr>

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

            </td>

         </tr>

      </table>
                   
   </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

MonthChangedEventArgs-Klasse
MonthChangedEventArgs-Member
System.Web.UI.WebControls-Namespace
System.DateTime
Calendar-Klasse
Calendar.VisibleDate-Eigenschaft
Calendar.VisibleMonthChanged-Ereignis

Freigeben über