Calendar.OnVisibleMonthChanged-Methode
Löst das VisibleMonthChanged-Ereignis des Calendar-Steuerelements aus und ermöglicht das Angeben eines benutzerdefinierten Handlers für das VisibleMonthChanged-Ereignis.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Overridable Sub OnVisibleMonthChanged ( _
newDate As DateTime, _
previousDate As DateTime _
)
'Usage
Dim newDate As DateTime
Dim previousDate As DateTime
Me.OnVisibleMonthChanged(newDate, previousDate)
protected virtual void OnVisibleMonthChanged (
DateTime newDate,
DateTime previousDate
)
protected:
virtual void OnVisibleMonthChanged (
DateTime newDate,
DateTime previousDate
)
protected void OnVisibleMonthChanged (
DateTime newDate,
DateTime previousDate
)
protected function OnVisibleMonthChanged (
newDate : DateTime,
previousDate : DateTime
)
Parameter
- newDate
Ein System.DateTime-Objekt, das den gegenwärtig im Calendar angezeigten Monat darstellt.
- previousDate
Ein System.DateTime-Objekt, das den im Calendar angezeigten vorherigen Monat darstellt.
Hinweise
Das VisibleMonthChanged-Ereignis wird ausgelöst, wenn der Benutzer im Titelbereich auf die Steuerelemente für die Navigation zum nächsten oder vorherigen Monat klickt.
Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Ereignisse und Delegaten.
Die OnVisibleMonthChanged-Methode ermöglicht es abgeleiteten Klassen auch, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Hinweise für Erben Beim Überschreiben von OnVisibleMonthChanged in einer abgeleiteten Klasse müssen Sie sicherstellen, dass die OnVisibleMonthChanged-Methode der Basisklasse aufgerufen wird, damit registrierte Delegaten das Ereignis empfangen.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie für das VisibleMonthChanged-Ereignis ein Handler angegeben und codiert wird, um anzuzeigen, ob im Calendar einen Monat vorwärts oder einen Monat zurück 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>
<%@ 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
Calendar-Klasse
Calendar-Member
System.Web.UI.WebControls-Namespace
VisibleMonthChanged
System.DateTime