Gets or sets the date that specifies the month to display on the
Calendar control.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
Visual Basic (Declaration)
<BindableAttribute(True)> _
Public Property VisibleDate As DateTime
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)
Property Value
A
System.DateTime that specifies the month to display on the
Calendar. The default value is
DateTime.MinValue, which displays the month that contains the date specified by
TodaysDate.
Remarks
Use the VisibleDate property to programmatically set the month to display on the Calendar control. The specified date can be any date in the month you want to display, although it is common to use the first date in the month. This property is set using a System.DateTime object.
The VisibleDate property is updated before the VisibleMonthChanged event is raised. You can provide a custom OnVisibleMonthChanged event handler to set the VisibleDate property and override the automatically generated value.
Example
The following code example demonstrates how to use the VisibleDate property to programmatically set the value that determines the month that is displayed in the Calendar control.
<%@ 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>
Platforms
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
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
Version Information
.NET Framework
Supported in: 2.0, 1.1, 1.0
See Also