Calendar.VisibleDate-Eigenschaft
Ruft das Datum ab, das den im Calendar-Steuerelement anzuzeigenden Monat angibt, oder legt dieses fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<BindableAttribute(True)> _
Public Property VisibleDate As DateTime
'Usage
Dim instance As Calendar
Dim value As DateTime
value = instance.VisibleDate
instance.VisibleDate = value
[BindableAttribute(true)]
public DateTime VisibleDate { get; set; }
[BindableAttribute(true)]
public:
property DateTime VisibleDate {
DateTime get ();
void set (DateTime value);
}
/** @property */
public DateTime get_VisibleDate ()
/** @property */
public void set_VisibleDate (DateTime value)
public function get VisibleDate () : DateTime
public function set VisibleDate (value : DateTime)
Eigenschaftenwert
Ein System.DateTime-Objekt, das den Monat angibt, der im Calendar angezeigt werden soll. Der Standardwert ist DateTime.MinValue und bewirkt, dass der Monat angezeigt wird, in dem das von TodaysDate angegebene Datum liegt.
Hinweise
Mit der VisibleDate-Eigenschaft legen Sie programmgesteuert den Monat fest, der im Calendar-Steuerelement angezeigt werden soll. Das angegebene Datum kann ein beliebiges Datum im anzuzeigenden Monat sein, i. d. R. wird jedoch das erste Datum im Monat verwendet. Diese Eigenschaft wird mithilfe eines System.DateTime-Objekts festgelegt.
Die VisibleDate-Eigenschaft wird aktualisiert, bevor das VisibleMonthChanged-Ereignis ausgelöst wird. Sie können einen benutzerdefinierten OnVisibleMonthChanged-Ereignishandler bereitstellen, um die VisibleDate-Eigenschaft festzulegen und den automatisch generierten Wert zu überschreiben.
| 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 mit der VisibleDate-Eigenschaft der Wert programmgesteuert festgelegt wird, der den im Calendar-Steuerelement angezeigten Monat bestimmt.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script language="VB" runat="server">
Sub ButtonClick(sender As Object, e As EventArgs)
Calendar1.VisibleDate = New DateTime(Calendar1.TodaysDate.Year, DropList1.SelectedIndex + 1, 1)
Label1.Text = "The VisibleDate property is " & Calendar1.VisibleDate.ToShortDateString()
End Sub 'ButtonClick
</script>
</head>
<body>
<form runat="server">
<h3>Calendar Example</h3>
<asp:Calendar id="Calendar1" runat="server"
SelectionMode="None"
ShowGridLines="True">
<SelectedDayStyle BackColor="Yellow"
ForeColor="Red">
</SelectedDayStyle>
</asp:Calendar>
<hr><br>
Select the month to display: <br>
<asp:DropDownList id="DropList1" runat="server">
<asp:ListItem>1</asp:ListItem>
<asp:ListItem>2</asp:ListItem>
<asp:ListItem>3</asp:ListItem>
<asp:ListItem>4</asp:ListItem>
<asp:ListItem>5</asp:ListItem>
<asp:ListItem>6</asp:ListItem>
<asp:ListItem>7</asp:ListItem>
<asp:ListItem>8</asp:ListItem>
<asp:ListItem>9</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
<asp:ListItem>11</asp:ListItem>
<asp:ListItem>12</asp:ListItem>
</asp:DropDownList>
<asp:Button id="Button1"
Text="Submit"
OnClick="ButtonClick"
runat=server />
<br><br>
<asp:Label id="Label1" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script language="C#" runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Calendar1.VisibleDate = new DateTime(Calendar1.TodaysDate.Year,
DropList1.SelectedIndex + 1,
1);
Label1.Text = "The VisibleDate property is " +
Calendar1.VisibleDate.ToShortDateString();
}
</script>
</head>
<body>
<form runat="server">
<h3>Calendar Example</h3>
<asp:Calendar id="Calendar1" runat="server"
SelectionMode="None"
ShowGridLines="True">
<SelectedDayStyle BackColor="Yellow"
ForeColor="Red">
</SelectedDayStyle>
</asp:Calendar>
<hr><br>
Select the month to display: <br>
<asp:DropDownList id="DropList1" runat="server">
<asp:ListItem>1</asp:ListItem>
<asp:ListItem>2</asp:ListItem>
<asp:ListItem>3</asp:ListItem>
<asp:ListItem>4</asp:ListItem>
<asp:ListItem>5</asp:ListItem>
<asp:ListItem>6</asp:ListItem>
<asp:ListItem>7</asp:ListItem>
<asp:ListItem>8</asp:ListItem>
<asp:ListItem>9</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
<asp:ListItem>11</asp:ListItem>
<asp:ListItem>12</asp:ListItem>
</asp:DropDownList>
<asp:Button id="Button1"
Text="Submit"
OnClick="ButtonClick"
runat=server />
<br><br>
<asp:Label id="Label1" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
<script language="JScript" runat="server">
function ButtonClick(sender : Object, e : EventArgs)
{
Calendar1.VisibleDate = new DateTime(Calendar1.TodaysDate.Year,
DropList1.SelectedIndex + 1,
1);
Label1.Text = "The VisibleDate property is " +
Calendar1.VisibleDate.ToShortDateString();
}
</script>
</head>
<body>
<form runat="server">
<h3>Calendar Example</h3>
<asp:Calendar id="Calendar1" runat="server"
SelectionMode="None"
ShowGridLines="True">
<SelectedDayStyle BackColor="Yellow"
ForeColor="Red">
</SelectedDayStyle>
</asp:Calendar>
<hr><br>
Select the month to display: <br>
<asp:DropDownList id="DropList1" runat="server">
<asp:ListItem>1</asp:ListItem>
<asp:ListItem>2</asp:ListItem>
<asp:ListItem>3</asp:ListItem>
<asp:ListItem>4</asp:ListItem>
<asp:ListItem>5</asp:ListItem>
<asp:ListItem>6</asp:ListItem>
<asp:ListItem>7</asp:ListItem>
<asp:ListItem>8</asp:ListItem>
<asp:ListItem>9</asp:ListItem>
<asp:ListItem>10</asp:ListItem>
<asp:ListItem>11</asp:ListItem>
<asp:ListItem>12</asp:ListItem>
</asp:DropDownList>
<asp:Button id="Button1"
Text="Submit"
OnClick="ButtonClick"
runat=server />
<br><br>
<asp:Label id="Label1" runat="server"/>
</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
System.DateTime
VisibleMonthChanged