MonthChangedEventArgs Class
TOC
Collapse the table of content
Expand the table of content

MonthChangedEventArgs Class

 

Provides data for the VisibleMonthChanged event of a Calendar control.

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

System.Object
  System.Web.UI.WebControls.MonthChangedEventArgs

public class MonthChangedEventArgs

NameDescription
System_CAPS_pubmethodMonthChangedEventArgs(DateTime, DateTime)

Initializes a new instance of the MonthChangedEventArgs class.

NameDescription
System_CAPS_pubpropertyNewDate

Gets the date that determines the currently displayed month in the Calendar control.

System_CAPS_pubpropertyPreviousDate

Gets the date that determines the previously displayed month in the Calendar control.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

The VisibleMonthChanged event is raised when the user clicks the Calendar navigation controls to display the next or previous month.

For a list of initial property values for an instance of MonthChangedEventArgs, see the MonthChangedEventArgs constructor.

For more information about handling events, see NIB: Events and Delegates.

The following code example demonstrates how to specify and code a handler for the VisibleMonthChanged event that displays in a Label control whether the Calendar control has moved forward or backward one month.

<%@ 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="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.";
         }

      }

      void Page_Load(Object sender, EventArgs e)
      {

         // Manually register the event-handling method for the  
         // VisibleMonthChanged event of the Calendar control.
         Calendar1.VisibleMonthChanged += 
            new MonthChangedEventHandler(this.MonthChange);

      }

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

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

.NET Framework
Available since 1.1

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft