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;
- }
- }
【编辑推荐】