C#編寫(xiě)Calendar控件淺析
C#語(yǔ)言還是比較常見(jiàn)的東西，這里我們主要介紹C#編寫(xiě)Calendar控件，包括介紹在C#中可以開(kāi)發(fā)兩種服務(wù)器控件，一個(gè)是用戶(hù)控件（User Control）和自定義控件（Custom Control）等方面。
Visual C#.net是微軟公司出品的一種新的編程語(yǔ)言（以下簡(jiǎn)稱(chēng)C#），它繼承了C語(yǔ)言的一些特性，也加入了一些新的元素。以前用過(guò)Delphi開(kāi)發(fā)程序的人可能剛開(kāi)始使用C#的時(shí)候，對(duì)其有一種似曾相識(shí)的感覺(jué)（至少包括我）。是的，C#語(yǔ)言的創(chuàng)始人正是以前在Borland公司開(kāi)發(fā)出Delphi語(yǔ)言的Anders Hejlsberg。在我開(kāi)始使用C#開(kāi)發(fā)程序時(shí)，就覺(jué)得它是一款很棒的開(kāi)發(fā)Windows Form & Web程序的RAD工具。
在開(kāi)發(fā)Web程序方面，C#的出現(xiàn)打破了以前的網(wǎng)頁(yè)開(kāi)發(fā)模式，實(shí)現(xiàn)了與開(kāi)發(fā)Windows
Form程序一樣的所見(jiàn)即所得的功能。C#提供了一些常用的Web Form Control供開(kāi)發(fā)人員使用，并且只需將控件拖入頁(yè)面中即可，非常簡(jiǎn)單。但有時(shí)這些控件也不能滿(mǎn)足開(kāi)發(fā)人員的需要，需要開(kāi)發(fā)人員自己編寫(xiě)用戶(hù)控件（User Control）或自定義控件（Custom Control）來(lái)滿(mǎn)足需求。在這里，我將講解如何C#編寫(xiě)Calendar控件。
一、預(yù)備知識(shí)
在C#中可以開(kāi)發(fā)兩種服務(wù)器控件，一個(gè)是用戶(hù)控件（User Control）和自定義控件（Custom Control）。用戶(hù)控件的本質(zhì)與頁(yè)面文件（ASPx文件）差不多，是可被其它aspx頁(yè)面重復(fù)使用的HTML代碼段，當(dāng)然它也包括后臺(tái)代碼（Code-behind），后綴名是ascx。所以在開(kāi)發(fā)一些公用的靜態(tài)頁(yè)面時(shí)（例如頁(yè)頭，頁(yè)腳）經(jīng)常用到，但它的缺點(diǎn)是不易繼承，不易分發(fā)，無(wú)法編譯成二進(jìn)制代碼來(lái)進(jìn)行部署。但是自定義控件的功能就強(qiáng)大許多，它可以被編譯成二進(jìn)制代碼（DLL文件），可以被擴(kuò)展、繼承、分發(fā)。就像Web Form Control一樣，其實(shí)它們每個(gè)控件就是一個(gè)DLL文件。
開(kāi)發(fā)用戶(hù)控件比較簡(jiǎn)單，就像編寫(xiě)一個(gè)aspx頁(yè)面一樣，在這里就不介紹了。本文對(duì)象是自定義控件。服務(wù)器控件的基類(lèi)是System.Web.UI.Control。如果要開(kāi)發(fā)可視化的服務(wù)器控件，那我們需要從 System.Web.UI.WebControls來(lái)繼承，否則從System.Web.UI.Control繼承。
服務(wù)器控件在設(shè)計(jì)時(shí)以runat=”server”腳本代碼嵌入到aspx文件中來(lái)表示此控件是在服務(wù)器端運(yùn)行的。在服務(wù)器控件所在頁(yè)面提交回傳（PostBack）過(guò)程中是依靠ViewState（視圖狀態(tài)）來(lái)維護(hù)控件狀態(tài)的。所以我們?cè)谠O(shè)計(jì)服務(wù)器控件屬性時(shí)，其值應(yīng)保存在ViewState 中。
二、代碼編寫(xiě)
C#編寫(xiě)Calendar控件，但是現(xiàn)在我需要一個(gè)可以下拉的日歷控件，并且初始時(shí)不顯示日歷，當(dāng)我點(diǎn)擊下拉按鈕時(shí)才彈出，并且當(dāng)選擇了日期，日歷會(huì)自動(dòng)隱藏且選擇的日期值會(huì)顯示到相應(yīng)的輸入框中。顯然Calendar控件不能滿(mǎn)足我的需要，但是稍后我會(huì)在我的自定義控件中用到它。
首先新建項(xiàng)目，在項(xiàng)目類(lèi)型中選擇Visual C#項(xiàng)目，在模板列表中選擇Web控件庫(kù)，輸入項(xiàng)目名稱(chēng)AquaCalendar，然后選擇項(xiàng)目所在目錄，點(diǎn)擊【確定】按鈕。C#將會(huì)生成基本的框架代碼。將項(xiàng)目中的類(lèi)文件和類(lèi)名改名為DatePicker（即日期控件的類(lèi)名）。由于DatePicker是可視化控件，所以我們必須從System.Web.UI.WebControls繼承。并且它包括一個(gè)輸入框，一個(gè)按鈕和日歷控件，需要在DatePicker類(lèi)中聲明它們。像這種以多個(gè)服務(wù)器控件組合的控件成為復(fù)合控件。代碼如下，比較重要的方法和代碼在注釋中會(huì)加以說(shuō)明：
- using System;
- using System.Web.UI;
- using System.Web.UI.WebControls;
- using System.ComponentModel;
- using System.Drawing;
- namespace AquaCalendar
- {
- [DefaultProperty("Text"),
- //在屬性工具箱中顯示的默認(rèn)屬性
- ToolboxData("<{0}:DatePicker runat=server>")]
- public class DatePicker :
- System.Web.UI.WebControls.WebControl ,
- IPostBackEventHandler
- {
- //選擇日期按鈕的默認(rèn)樣式
- 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;";
- //按鈕默認(rèn)文本
- private const string _BUTTONDEFAULTTEXT = "...";
- private System.Web.UI.WebControls.Calendar _Calendar;
- public override ControlCollection Controls
- {
- get
- {
- EnsureChildControls(); //確認(rèn)子控件集都已被創(chuàng)建
- return base.Controls;
- }
- }
- //創(chuàng)建子控件（服務(wù)器日歷控件）
- 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"); //默認(rèn)不顯示下拉日歷控件
- _Calendar.SelectionChanged += new EventHandler(_Calendar_SelectionChanged);
- this.Controls.Add(_Calendar);
- }
- [
- Category("Appearance"), //該屬性所屬類(lèi)別，參見(jiàn)圖
- DefaultValue(""), //屬性默認(rèn)值
- Description("設(shè)置該日期控件的值。") //屬性的描述
- ]
- 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("請(qǐng)輸入日期型字符串（例如：1981-04-29）！");
- }
- ViewState["Text"] = DateFormat == CalendarEnum.LongDateTime?dt.
ToString("yyyy-MM-dd"):dt.ToString("yyyy-M-d");- }
- }
- //重載服務(wù)器控件的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 //復(fù)合控件ID
- {
- get
- {
- EnsureChildControls();
- return this.ClientID+"_MyCalendar";
- }
- }
- [
- Browsable(false),
- DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
- ]
- public string MyCalendarName //復(fù)合控件名稱(chēng)
- {
- get
- {
- EnsureChildControls();
- return this.UniqueID+":MyCalendar";
- }
- }
- [
- Browsable(false),
- DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
- ]
- public string DatePickerInputID //復(fù)合控件中輸入框的ID
- {
- get
- {
- EnsureChildControls();
- return this.ClientID+"_DateInput";
- }
- }
- [
- Browsable(false),
- DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
- ]
- public string DatePickerInputName //復(fù)合控件中輸入框的名稱(chēng)
- {
- get
- {
- EnsureChildControls();
- return this.UniqueID+":DateInput";
- }
- }
- [
- Browsable(false),
- DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
- ]
- public string DatePickerButtonID //復(fù)合控件中按鈕的ID
- {
- get
- {
- EnsureChildControls();
- return this.ClientID+"_DateButton";
- }
- }
- [
- Browsable(false),
- DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)
- ]
- public string DatePickerButtonName //復(fù)合控件中按鈕的名稱(chēng)
- {
- get
- {
- EnsureChildControls();
- return this.UniqueID+":DateButton";
- }
- }
- public string ButtonText
- {
- get
- {
- EnsureChildControls();
- return ViewState["ButtonText"] == null?_BUTTONDEFAULTTEXT:
(string)ViewState["ButtonText"];- }
- set
- {
- EnsureChildControls();
- ViewState["ButtonText"] = value;
- }
- }
【編輯推薦】
