Calendar 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
顯示單一月份的行事曆，讓使用者可以選取日期並移至下個月或上個月。
public ref class Calendar : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandlerpublic class Calendar : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler[System.Web.UI.ControlValueProperty("SelectedDate", typeof(System.DateTime), "1/1/0001")]
public class Calendar : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandlertype Calendar = class
inherit WebControl
interface IPostBackEventHandler[<System.Web.UI.ControlValueProperty("SelectedDate", typeof(System.DateTime), "1/1/0001")>]
type Calendar = class
inherit WebControl
interface IPostBackEventHandlerPublic Class Calendar
Inherits WebControl
Implements IPostBackEventHandler- 繼承
- 屬性
- 實作
範例
下列程式代碼範例示範如何在網頁上建立 Calendar 控件。
<%@ 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>
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:Calendar id="calendar1" runat="server">
<OtherMonthDayStyle ForeColor="LightGray">
</OtherMonthDayStyle>
<TitleStyle BackColor="Blue"
ForeColor="White">
</TitleStyle>
<DayStyle BackColor="gray">
</DayStyle>
<SelectedDayStyle BackColor="LightGray"
Font-Bold="True">
</SelectedDayStyle>
</asp:Calendar>
</form>
</body>
</html>
<%@ Page Language="VB" 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>
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:Calendar id="calendar1" runat="server">
<OtherMonthDayStyle ForeColor="LightGray">
</OtherMonthDayStyle>
<TitleStyle BackColor="Blue"
ForeColor="White">
</TitleStyle>
<DayStyle BackColor="gray">
</DayStyle>
<SelectedDayStyle BackColor="LightGray"
Font-Bold="True">
</SelectedDayStyle>
</asp:Calendar>
</form>
</body>
</html>
下列範例顯示 Calendar 編輯控制項所顯示之其中一個 GridView 數據行時所使用的控件。 控件 Calendar 會使用 Bind 方法系結至數據源。 方法 Eval 可用來系結 控件所 Calendar 顯示的日期值。
<Columns>
<asp:BoundField DataField="EmployeeID" HeaderText="Employee ID" ReadOnly="true"/>
<asp:BoundField DataField="FirstName" HeaderText="First Name"/>
<asp:BoundField DataField="LastName" HeaderText="Last Name"/>
<asp:TemplateField HeaderText="Birth Date">
<ItemTemplate>
<asp:Label ID="BirthDateLabel" Runat="Server"
Text='<%# Eval("BirthDate", "{0:d}") %>' />
</ItemTemplate>
<EditItemTemplate>
<asp:Calendar ID="EditBirthDateCalendar" Runat="Server"
VisibleDate='<%# Eval("BirthDate") %>'
SelectedDate='<%# Bind("BirthDate") %>' />
</EditItemTemplate>
</asp:TemplateField>
<asp:HyperLinkField Text="Show Detail"
DataNavigateUrlFormatString="~/ShowEmployeeDetail.aspx?EmployeeID={0}"
DataNavigateUrlFields="EmployeeID" />
</Columns>
<Columns>
<asp:BoundField DataField="EmployeeID" HeaderText="Employee ID" ReadOnly="true"/>
<asp:BoundField DataField="FirstName" HeaderText="First Name"/>
<asp:BoundField DataField="LastName" HeaderText="Last Name"/>
<asp:TemplateField HeaderText="Birth Date">
<ItemTemplate>
<asp:Label ID="BirthDateLabel" Runat="Server"
Text='<%# Eval("BirthDate", "{0:d}") %>' />
</ItemTemplate>
<EditItemTemplate>
<asp:Calendar ID="EditBirthDateCalendar" Runat="Server"
VisibleDate='<%# Eval("BirthDate") %>'
SelectedDate='<%# Bind("BirthDate") %>' />
</EditItemTemplate>
</asp:TemplateField>
<asp:HyperLinkField Text="Show Detail"
DataNavigateUrlFormatString="~/ShowEmployeeDetail.aspx?EmployeeID={0}"
DataNavigateUrlFields="EmployeeID" />
</Columns>
備註
本主題內容：
簡介
Calendar使用 控件，在網頁上顯示行事曆的單一月份。 控件可讓您選取日期，並移至下一個或上一個月。 控制項 Calendar 支援 System.Globalization.Calendar 命名空間中的所有 System.Globalization 類型。 除了公曆之外，這也包括使用不同年份和月份系統的行事曆，例如回歷。
您可以藉由設定 SelectionMode 屬性，指定控件是否Calendar允許您選取單一日期、周或整個月。
根據預設，控件會顯示月份的天數、星期幾的日標題、具有月份名稱和年份的標題、選取月份個別天數的連結，以及移至下一個和上個月的連結。 您可以藉由設定控件不同部分之樣式的屬性，來自定義控件的外觀 Calendar 。 下表列出指定控件不同部分樣式的屬性。
| 屬性 | 說明 |
|---|---|
| DayHeaderStyle | 指定顯示星期幾之區段的樣式。 |
| DayStyle | 指定顯示月份中日期的樣式。 |
| NextPrevStyle | 指定標題區段中導覽控件的樣式。 |
| OtherMonthDayStyle | 指定目前未顯示月份之日期的樣式。 |
| SelectedDayStyle | 指定行事曆上所選日期的樣式。 |
| SelectorStyle | 指定周和月日期選取數據行的樣式。 |
| TitleStyle | 指定標題區段的樣式。 |
| TodayDayStyle | 指定今天日期的樣式。 |
| WeekendDayStyle | 指定週末日期的樣式。 |
您也可以顯示或隱藏控制件的不同部分。 下表列出控制要顯示或隱藏哪些元件的屬性。
| 屬性 | 說明 |
|---|---|
| ShowDayHeader | 顯示或隱藏顯示星期幾的區段。 |
| ShowGridLines | 顯示或隱藏月份天數之間的網格線。 |
| ShowNextPrevMonth | 顯示或隱藏下一個或上一個月的導覽控件。 |
| ShowTitle | 顯示或隱藏標題區段。 |
雖然控件不支援 Calendar 系結至數據源，但您可以修改個別日期儲存格的內容和格式。 在 Calendar 控件顯示在網頁上之前，它會建立並組合組成控件的元件。 DayRender建立 控件中的每個Calendar日期數據格時，就會引發 事件。 您可以藉由在事件的事件處理程式 DayRender 中提供程式碼，來控制日期儲存格的內容和格式設定。 如需自訂日期儲存格內容的詳細資訊，請參閱 OnDayRender。
注意
控件會將 Calendar ECMAScript (JScript、JavaScript) 轉譯為客戶端瀏覽器。 用戶端瀏覽器必須啟用 ECMAScript，此控件才能正常運作。 如需用戶端文本的詳細資訊，請參閱 ASP.NET 網頁中的用戶端腳本。
Accessibility
根據預設，此控件所轉譯的標記可能不符合輔助功能標準。 如需此控件輔助功能支援的詳細資訊，請參閱 ASP.NET 控件和輔助功能。
宣告式語法
<asp:Calendar
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
Caption="string"
CaptionAlign="NotSet|Top|Bottom|Left|Right"
CellPadding="integer"
CellSpacing="integer"
CssClass="string"
DayNameFormat="Full|Short|FirstLetter|FirstTwoLetters|Shortest"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
FirstDayOfWeek="Sunday|Monday|Tuesday|Wednesday|Thursday|Friday|
Saturday|Default"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
NextMonthText="string"
NextPrevFormat="CustomText|ShortMonth|FullMonth"
OnDataBinding="DataBinding event handler"
OnDayRender="DayRender event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectionChanged="SelectionChanged event handler"
OnUnload="Unload event handler"
OnVisibleMonthChanged="VisibleMonthChanged event handler"
PrevMonthText="string"
runat="server"
SelectedDate="string"
SelectionMode="None|Day|DayWeek|DayWeekMonth"
SelectMonthText="string"
SelectWeekText="string"
ShowDayHeader="True|False"
ShowGridLines="True|False"
ShowNextPrevMonth="True|False"
ShowTitle="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
TitleFormat="Month|MonthYear"
ToolTip="string"
UseAccessibleHeader="True|False"
Visible="True|False"
VisibleDate="string"
Width="size"
>
<DayHeaderStyle/>
<DayStyle/>
<NextPrevStyle/>
<OtherMonthDayStyle/>
<SelectedDayStyle/>
<SelectorStyle/>
<TitleStyle/>
<TodayDayStyle/>
<WeekendDayStyle/>
</asp:Calendar>
建構函式
| Calendar() |
初始化 Calendar 類別的新執行個體。 |
屬性
| AccessKey |
取得或設定便捷鍵 (Access Key)，可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
| Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
| AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得任意屬性 (Attribute) 的集合 (只供呈現)，不與控制項上的屬性 (Property) 對應。 (繼承來源 WebControl) |
| BackColor |
取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 WebControl) |
| BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
| BorderColor |
取得或設定 Web 控制項的框線色彩。 (繼承來源 WebControl) |
| BorderStyle |
取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 WebControl) |
| BorderWidth |
取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 WebControl) |
| Caption |
取得或設定呈現為月曆標題的文字值。 |
| CaptionAlign |
取得或設定呈現為月曆標題之文字的對齊方式。 |
| CellPadding |
取得或設定儲存格內容和其框線之間的間距。 |
| CellSpacing |
取得或設定儲存格之間的間距。 |
| ChildControlsCreated |
取得值，指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
| ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
取得字元值，表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
| Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 物件，表示 UI 階層架構中指定之伺服器控制項的子控制項。 (繼承來源 Control) |
| ControlStyle |
取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| ControlStyleCreated |
取得值，指出 Style 物件是否已經為 ControlStyle 屬性建立。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| CssClass |
取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承來源 WebControl) |
| DataItemContainer |
如果命名容器實作 IDataItemContainer，則取得命名容器的參考。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實作 IDataKeysControl，則取得命名容器的參考。 (繼承來源 Control) |
| DayHeaderStyle |
取得顯示星期區段的樣式屬性。 |
| DayNameFormat |
取得或設定星期的名稱格式。 |
| DayStyle |
取得所顯示月份中日期的樣式屬性。 |
| DesignMode |
取得值，指出控制項是否正用於設計介面上。 (繼承來源 Control) |
| Enabled |
取得或設定值，指出 Web 伺服器控制項是否啟用。 (繼承來源 WebControl) |
| EnableTheming |
取得或設定值，指出佈景主題是否套用至此控制項。 (繼承來源 WebControl) |
| EnableViewState |
取得或設定值，該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態，以及它包含的任何子控制項狀態。 (繼承來源 Control) |
| Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
| FirstDayOfWeek |
取得或設定星期，其將顯示於 Calendar 控制項的第一個日期欄位。 |
| Font |
取得與 Web 伺服器控制項關聯的字型屬性。 (繼承來源 WebControl) |
| ForeColor |
取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承來源 WebControl) |
| HasAttributes |
取得值，指出控制項是否已經設定屬性。 (繼承來源 WebControl) |
| HasChildViewState |
取得值，指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control) |
| Height |
取得或設定 Web 伺服器控制項的高度。 (繼承來源 WebControl) |
| ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
| IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
| IsChildControlStateCleared |
取得值，指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control) |
| IsEnabled |
取得值，指出是否啟用控制項。 (繼承來源 WebControl) |
| IsTrackingViewState |
取得值，指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control) |
| IsViewStateEnabled |
取得值，指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control) |
| LoadViewStateByID |
取得值，指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control) |
| NamingContainer |
取得伺服器控制項命名容器的參考，其建立唯一命名空間，在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control) |
| NextMonthText |
取得或設定顯示於移往下個月份巡覽控制項的文字。 |
| NextPrevFormat |
取得或設定在 Calendar 控制項的標題區段中往上和往下月份巡覽項目的格式。 |
| NextPrevStyle |
取得往下和往上月份巡覽項目的樣式屬性。 |
| OtherMonthDayStyle |
取得 Calendar 控制項上，不在顯示月份中日期的樣式屬性。 |
| Page |
取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control) |
| Parent |
在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control) |
| PrevMonthText |
取得或設定顯示於移往上個月份巡覽控制項的文字。 |
| RenderingCompatibility |
取得值，這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control) |
| SelectedDate |
取得或設定選取的日期。 |
| SelectedDates | |
| SelectedDayStyle |
取得選取日期的樣式屬性。 |
| SelectionMode |
取得或設定 Calendar 控制項上的日期選取模式，指定使用者是否可以選取單一日、週或整個月份。 |
| SelectMonthText |
取得或設定顯示於選取器欄位中月份選取項目的文字。 |
| SelectorStyle |
取得週和月份選取器欄位的樣式屬性。 |
| SelectWeekText |
取得或設定顯示於選取器欄位中的週選取項目的文字。 |
| ShowDayHeader |
取得或設定值，指出是否顯示星期的標題。 |
| ShowGridLines |
取得或設定值，其指出 Calendar 控制項上的日期是否以格線分隔。 |
| ShowNextPrevMonth |
取得或設定值，指出 Calendar 控制項是否在標題區段中顯示往下或往上月份巡覽項目。 |
| ShowTitle |
取得或設定值，指出是否顯示標題區段。 |
| Site |
當呈現在設計介面上時，取得裝載目前控制項之容器的資訊。 (繼承來源 Control) |
| SkinID |
取得或設定要套用至控制項的面板。 (繼承來源 WebControl) |
| Style |
取得文字屬性的集合，將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。 (繼承來源 WebControl) |
| SupportsDisabledAttribute |
取得值，這個值表示當控制項的 |
| SupportsDisabledAttribute |
取得值，這個值表示當控制項的 |
| TabIndex |
取得或設定 Web 伺服器控制項的定位索引。 (繼承來源 WebControl) |
| TagKey |
取得對應至這個 Web 伺服器控制項的 HtmlTextWriterTag 值。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| TagName |
取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
| TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
| TitleFormat |
取得或設定標題區段的格式。 |
| TitleStyle |
取得 Calendar 控制項標題的樣式屬性。 |
| TodayDayStyle |
取得 Calendar 控制項中今天日期的樣式屬性。 |
| TodaysDate |
取得或設定今天日期的值。 |
| ToolTip |
取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。 (繼承來源 WebControl) |
| UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
| UseAccessibleHeader |
取得或設定值，表示是否為日期標頭呈現資料表標頭 |
| ValidateRequestMode |
取得或設定值，指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
| ViewState |
取得狀態資訊的字典，允許您在相同網頁的多個要求之間，儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
| ViewStateIgnoresCase |
取得值，指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定值，指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
| VisibleDate | |
| WeekendDayStyle |
取得 Calendar 控制項中週末日期的樣式屬性。 |
| Width |
取得或設定 Web 伺服器控制項的寬度。 (繼承來源 WebControl) |
方法
事件
| DataBinding |
發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control) |
| DayRender |
發生於各個日期在 Calendar 控制項的控制項階層架構中建立時。 |
| Disposed |
發生於伺服器控制項從記憶體釋放時，這是在要求 ASP.NET 網頁時，伺服器控制項生命週期的最後階段。 (繼承來源 Control) |
| Init |
發生於初始化伺服器控制項時，是其生命週期中的第一個步驟。 (繼承來源 Control) |
| Load |
發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control) |
| PreRender |
在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control) |
| SelectionChanged |
發生於使用者按一下日期選取器控制項以選取日、週或整個月份時。 |
| Unload |
發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control) |
| VisibleMonthChanged |
發生於使用者按一下標題上的往下或往上月份巡覽控制項時。 |
明確介面實作
擴充方法
| FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
| FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
| FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |
