C#編寫Calendar控件淺析

作者：佚名 2009-08-28 15:05:35

這里介紹C#編寫Calendar控件，但是現在我需要一個可以下拉的日歷控件，并且初始時不顯示日歷，當我點擊下拉按鈕時才彈出，并且當選擇了日期，日歷會自動隱藏且選擇的日期值會顯示到相應的輸入框中。

C#語言還是比較常見的東西，這里我們主要介紹C#編寫Calendar控件，包括介紹在C#中可以開發兩種服務器控件，一個是用戶控件（User Control）和自定義控件（Custom Control）等方面。

Visual C#.net是微軟公司出品的一種新的編程語言（以下簡稱C#），它繼承了C語言的一些特性，也加入了一些新的元素。以前用過Delphi開發程序的人可能剛開始使用C#的時候，對其有一種似曾相識的感覺（至少包括我）。是的，C#語言的創始人正是以前在Borland公司開發出Delphi語言的Anders Hejlsberg。在我開始使用C#開發程序時，就覺得它是一款很棒的開發Windows Form & Web程序的RAD工具。
在開發Web程序方面，C#的出現打破了以前的網頁開發模式，實現了與開發Windows

Form程序一樣的所見即所得的功能。C#提供了一些常用的Web Form Control供開發人員使用，并且只需將控件拖入頁面中即可，非常簡單。但有時這些控件也不能滿足開發人員的需要，需要開發人員自己編寫用戶控件（User Control）或自定義控件（Custom Control）來滿足需求。在這里，我將講解如何C#編寫Calendar控件。

一、預備知識

在C#中可以開發兩種服務器控件，一個是用戶控件（User Control）和自定義控件（Custom Control）。用戶控件的本質與頁面文件（ASPx文件）差不多，是可被其它aspx頁面重復使用的HTML代碼段，當然它也包括后臺代碼（Code-behind），后綴名是ascx。所以在開發一些公用的靜態頁面時（例如頁頭，頁腳）經常用到，但它的缺點是不易繼承，不易分發，無法編譯成二進制代碼來進行部署。但是自定義控件的功能就強大許多，它可以被編譯成二進制代碼（DLL文件），可以被擴展、繼承、分發。就像Web Form Control一樣，其實它們每個控件就是一個DLL文件。

開發用戶控件比較簡單，就像編寫一個aspx頁面一樣，在這里就不介紹了。本文對象是自定義控件。服務器控件的基類是System.Web.UI.Control。如果要開發可視化的服務器控件，那我們需要從 System.Web.UI.WebControls來繼承，否則從System.Web.UI.Control繼承。

服務器控件在設計時以runat=”server”腳本代碼嵌入到aspx文件中來表示此控件是在服務器端運行的。在服務器控件所在頁面提交回傳（PostBack）過程中是依靠ViewState（視圖狀態）來維護控件狀態的。所以我們在設計服務器控件屬性時，其值應保存在ViewState 中。

二、代碼編寫

C#編寫Calendar控件，但是現在我需要一個可以下拉的日歷控件，并且初始時不顯示日歷，當我點擊下拉按鈕時才彈出，并且當選擇了日期，日歷會自動隱藏且選擇的日期值會顯示到相應的輸入框中。顯然Calendar控件不能滿足我的需要，但是稍后我會在我的自定義控件中用到它。

首先新建項目，在項目類型中選擇Visual C#項目，在模板列表中選擇Web控件庫，輸入項目名稱AquaCalendar，然后選擇項目所在目錄，點擊【確定】按鈕。C#將會生成基本的框架代碼。將項目中的類文件和類名改名為DatePicker（即日期控件的類名）。由于DatePicker是可視化控件，所以我們必須從System.Web.UI.WebControls繼承。并且它包括一個輸入框，一個按鈕和日歷控件，需要在DatePicker類中聲明它們。像這種以多個服務器控件組合的控件成為復合控件。代碼如下，比較重要的方法和代碼在注釋中會加以說明：

using System;  
using System.Web.UI;  
using System.Web.UI.WebControls;  
using System.ComponentModel;  
using System.Drawing;  
 
namespace AquaCalendar  
{  
[DefaultProperty("Text"),  
    //在屬性工具箱中顯示的默認屬性  
ToolboxData("<{0}:DatePicker runat=server>")]  
public class DatePicker :  
      System.Web.UI.WebControls.WebControl ,  
       IPostBackEventHandler  
{  
//選擇日期按鈕的默認樣式  
private const string _BUTTONDEFAULTSTYLE = "BORDER-RIGHT: gray 1px solid; 
BORDER-TOP: gray 1px solid; BORDER-LEFT: gray 1px solid; 
CURSOR: hand; 
BORDER-BOTTOM: gray 1px solid;";  
 
//按鈕默認文本  
 
private const string _BUTTONDEFAULTTEXT = "...";  
private System.Web.UI.WebControls.Calendar _Calendar;  
 
public override ControlCollection Controls  
{  
get  
{  
EnsureChildControls(); //確認子控件集都已被創建  
return base.Controls;  
}  
}  
 
//創建子控件（服務器日歷控件）  
 
protected override void CreateChildControls()  
{  
Controls.Clear();  
_Calendar = new Calendar();  
_Calendar.ID = MyCalendarID;  
_Calendar.SelectedDate = DateTime.Parse(Text);  
_Calendar.TitleFormat = TitleFormat.MonthYear;  
_Calendar.NextPrevFormat = NextPrevFormat.ShortMonth;  
_Calendar.CellSpacing = 0;  
_Calendar.Font.Size = FontUnit.Parse("9pt");  
_Calendar.Font.Name = "Verdana";  
_Calendar.SelectedDayStyle.BackColor = ColorTranslator.FromHtml("#333399");  
_Calendar.SelectedDayStyle.ForeColor = ColorTranslator.FromHtml("White");  
_Calendar.DayStyle.BackColor = ColorTranslator.FromHtml("#CCCCCC");  
_Calendar.TodayDayStyle.BackColor = ColorTranslator.FromHtml("#999999");  
_Calendar.TodayDayStyle.ForeColor = ColorTranslator.FromHtml("Aqua");  
_Calendar.DayHeaderStyle.Font.Size = FontUnit.Parse("8pt");  
_Calendar.DayHeaderStyle.Font.Bold = true;  
_Calendar.DayHeaderStyle.Height = Unit.Parse("8pt");  
_Calendar.DayHeaderStyle.ForeColor = ColorTranslator.FromHtml("#333333");  
_Calendar.NextPrevStyle.Font.Size = FontUnit.Parse("8pt");  
_Calendar.NextPrevStyle.Font.Bold = true;  
_Calendar.NextPrevStyle.ForeColor = ColorTranslator.FromHtml("White");  
_Calendar.TitleStyle.Font.Size = FontUnit.Parse("12pt");  
_Calendar.TitleStyle.Font.Bold = true;  
_Calendar.TitleStyle.Height = Unit.Parse("12pt");  
_Calendar.TitleStyle.ForeColor = ColorTranslator.FromHtml("White");  
_Calendar.TitleStyle.BackColor = ColorTranslator.FromHtml("#333399");  
_Calendar.OtherMonthDayStyle.ForeColor = ColorTranslator.FromHtml("#999999");  
_Calendar.NextPrevFormat = NextPrevFormat.CustomText;  
_Calendar.NextMonthText = "下月";  
_Calendar.PrevMonthText = "上月";  
_Calendar.Style.Add("display","none"); //默認不顯示下拉日歷控件  
_Calendar.SelectionChanged += new EventHandler(_Calendar_SelectionChanged);  
this.Controls.Add(_Calendar);  
}  
[  
Category("Appearance"), //該屬性所屬類別，參見圖  
DefaultValue(""), //屬性默認值  
Description("設置該日期控件的值。") //屬性的描述  
]  
 
public string Text  
{  
get  
{  
EnsureChildControls();  
return (ViewState["Text"] == null)?System.DateTime.Today.
ToString("yyyy-MM-dd"):ViewState["Text"].ToString();  
}  
set  
{  
EnsureChildControls();  
DateTime dt = System.DateTime.Today;  
try  
{  
dt = DateTime.Parse(value);  
}  
catch  
{  
throw new ArgumentOutOfRangeException("請輸入日期型字符串（例如：1981-04-29）！");  
}  
 
ViewState["Text"] = DateFormat == CalendarEnum.LongDateTime?dt.
ToString("yyyy-MM-dd"):dt.ToString("yyyy-M-d");  
}  
}  
 
//重載服務器控件的Enabled屬性，將選擇日期按鈕變灰（禁用）  
 
public override bool Enabled  
{  
get  
{  
EnsureChildControls();  
return ViewState["Enabled"] == null?true:(bool)ViewState["Enabled"];  
}  
set  
{  
EnsureChildControls();  
ViewState["Enabled"] = value;  
}  
}  
 
public string ButtonStyle  
{  
get  
{  
EnsureChildControls();  
object o = ViewState["ButtonSytle"];  
return (o == null)?_BUTTONDEFAULTSTYLE:o.ToString();  
}  
set  
{  
EnsureChildControls();  
ViewState["ButtonSytle"] = value;  
}  
}  
 
[  
DefaultValue(CalendarEnum.LongDateTime),  
]  
 
public CalendarEnum DateFormat  
{  
get  
{  
EnsureChildControls();  
object format = ViewState["DateFormat"];  
return format == null?CalendarEnum.LongDateTime:(CalendarEnum)format;  
}  
set  
{  
EnsureChildControls();  
ViewState["DateFormat"] = value;  
DateTime dt = DateTime.Parse(Text);  
Text=DateFormat == CalendarEnum.LongDateTime?dt.
ToString("yyyy-MM-dd"):dt.ToString("yyyy-M-d");  
}  
}  
 
[  
Browsable(false),  
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)  
]  
 
public string MyCalendarID //復合控件ID  
{  
get  
{  
EnsureChildControls();  
return this.ClientID+"_MyCalendar";  
}  
}  
 
[  
Browsable(false),  
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)  
]  
 
public string MyCalendarName //復合控件名稱  
{  
get  
{  
EnsureChildControls();  
return this.UniqueID+":MyCalendar";  
}  
}  
 
[  
Browsable(false),  
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)  
]  
 
public string DatePickerInputID //復合控件中輸入框的ID  
{  
get  
{  
EnsureChildControls();  
return this.ClientID+"_DateInput";  
}  
}  
 
[  
Browsable(false),  
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)  
]  
 
public string DatePickerInputName //復合控件中輸入框的名稱  
{  
get  
{  
EnsureChildControls();  
return this.UniqueID+":DateInput";  
}  
}  
 
[  
Browsable(false),  
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)  
]  
 
public string DatePickerButtonID //復合控件中按鈕的ID  
{  
get  
{  
EnsureChildControls();  
return this.ClientID+"_DateButton";  
}  
}  
 
[  
Browsable(false),  
DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)  
]  
 
public string DatePickerButtonName //復合控件中按鈕的名稱  
{  
get  
{  
EnsureChildControls();  
return this.UniqueID+":DateButton";  
}  
}  
 
public string ButtonText  
{  
get  
{  
EnsureChildControls();  
return ViewState["ButtonText"] == null?_BUTTONDEFAULTTEXT:
(string)ViewState["ButtonText"];  
}  
set  
{  
EnsureChildControls();  
ViewState["ButtonText"] = value;  
}  
}

【編輯推薦】

C#字符ASCII碼學習經驗
C#數值類型之間的轉換概述
日期型數據轉換成C#長整型數據
C#查看Excel對象模型分析
C#日期型數據簡單剖析

責任編輯：佚名來源：博客園

C#編寫Calendar控件