ASP.NET2.0服务器控件之类型化样式属性
继承自Style类的类称为类型化样式。Style类可以由控件开发人员来扩展,创建一个自定义类型化样式,它重写或者添加Style类的属性。服务器控件也可以把自定义类型化样式作为ControlStyle属性的类型。例如,Table控件的ControlStyle属性就是TableStyle类型,该类型是扩展的Style,添加了例如CellPadding、CellSpacing和GridLines属性等。在初步了解类型化样式属性的基本概念之后,下面列举了实现类型化样式属性的方法要点。
(1)创建一个派生自System.Web.UI.WebControls.Style的类;
(2)定义样式将为控件提供的属性。在Style的ViewState字典中保存该属性;
(3)重写CopyFrom和MergeWith方法,从定义的属性中复制或者将定义的属性和一个给定样式的属性合并;
(4)重写Reset方法,删除添加到ViewState中的属性;
(5)重写AddAttributesToRender方法,产生HTML和CSS特性,作为控件呈现过程的一部分。
实际上,创建类型化样式属性并不是一个简单的过程。为此,下面我们将通过典型应用示例来说明创建的具体方法,以便读者加深对于实现要点的理解。
典型应用
本节通过创建一个MyPanel控件以及相关联的类型化样式MyPanelStyle,来讲解如何实现并使用自定义类型化样式。就功能而言,MyPanel与ASP.NET 2.0内置的Panel控件是一致。开发人员可以通过把需要添加的控件嵌套在控件的标签中,向Controls集合中添加控件。在可视化设计器中,把所需添加的控件拖放到Panel的设计界面上,就可以把控件添加到Controls集合中。然而,MyPanel并不是从Panel类继承而来,而是自定义实现的结果,同时,该控件还提供了类型化样式属性MyPanelStyle,其中设置了3个样式属性:
(1)BackImageUrl,用于指定背景图片的URL;
(2)HorizontalAlign,用于指定所添加内容的水平对其方式;
(3)Wrap,用于指定是否允许对所添加的内容换行。
下面列举了示例效果图。
图1
如图1所示,图中显示了一个MyPanel控件,其中包括一行文字,文字的背景图像已经定义,并且文字处于居中位置。
下面列举了实现自定义服务器控件的MyPanel.cs源代码。
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
namespace WebControlLibrary{
[ ParseChildren(false), PersistChildren(true) ]
[ToolboxData("<{0}:MyPanel runat=server></{0}:MyPanel>")]
public class MyPanel : WebControl {
// 定义构造函数
public MyPanel() : base(HtmlTextWriterTag.Div) { }
// 实现属性BackImageUrl
[Bindable(true)] [Category("Appearance")]
[DefaultValue("")]
public virtual string BackImageUrl {
get {
if (ControlStyleCreated) {
return ((MyPanelStyle)ControlStyle).BackImageUrl;
}
return String.Empty;
}
set {
((MyPanelStyle)ControlStyle).BackImageUrl = value;
}
}
// 实现属性HorizontalAlign
[Bindable(true)]
[Category("Layout")]
[DefaultValue("")]
public virtual HorizontalAlign HorizontalAlign {
get {
if (ControlStyleCreated) {
return ((MyPanelStyle)ControlStyle).HorizonalAlign;
}
return HorizontalAlign.NotSet;
}
set {
((MyPanelStyle)ControlStyle).HorizonalAlign = value;
}
}
// 实现属性Wrap
[Bindable(true)]
[Category("Layout")]
[DefaultValue("")]
public virtual bool Wrap {
get {
if (ControlStyleCreated) {
return ((MyPanelStyle)ControlStyle).Wrap;
}
return true;
}
set {
((MyPanelStyle)ControlStyle).Wrap = value;
}
}
protected override Style CreateControlStyle() {
return new MyPanelStyle(ViewState);
}
}
}
在分析之前,为了帮助读者更好的阅读以上源代码,下面列举了MyPanel类图。
图2
如上代码所示,MyPanel继承自WebControl基类,其中定义了3个属性BackImageUrl、HorizontalAlign和Wrap。关于这3个属性的说明,读者可参考前面的内容。另外,MyPanel重写了CreateControlStyle方法,返回一个MyPanelStyle对象。这样返回的MyPanelStyle实例间接的赋值给ControlStyle属性。这种实现方法的原因是由于ControlStyle属性是只读属性,且它的访问操作需要调用CreateControlStyle方法时间接进行设置。需要读者注意的是,CreateControlStyle将MyPanel控件的ViewState传递给MyPanelStyle的构造函数。当在CreateControlStyle中为控件创建新样式时,必须将控件的ViewState传给Style构造函数,那么样式对象则使用和控件相同的StateBag。
下面列举了实现MyPanelStyle类的源代码,它们来自MyPanelStyle.cs文件。
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
namespace WebControlLibrary{
public class MyPanelStyle : Style {
// 定义内部常量
internal const int PROP_BACKIMAGEURL = 1;
internal const int PROP_HORIZONTALALIGN = 2;
internal const int PROP_WRAP = 3;
//构造函数一
public MyPanelStyle() { }
// 构造函数二
public MyPanelStyle(StateBag bag) : base(bag) { }
// 创建BackImageUrl属性
[ Bindable(true), Category("Appearance"), DefaultValue(""), Description("背景图片的URL"), NotifyParentProperty(true) ]
public virtual string BackImageUrl {
get {
if (IsSet(PROP_BACKIMAGEURL)) {
return (string)ViewState["BackImageUrl"];
}
return String.Empty;
}
set {
ViewState["BackImageUrl"] = value;
}
}
// 实现HorizonalAlign属性
[ Bindable(true), Category("Layout"), DefaultValue(HorizontalAlign.NotSet), Description("所添加内容的水平对其方式"), NotifyParentProperty(true) ]
public virtual HorizontalAlign HorizonalAlign {
get {
if (IsSet(PROP_HORIZONTALALIGN)) {
return (HorizontalAlign)ViewState["HorizontalAlign"];
}
return HorizontalAlign.NotSet;
}
set {
if (value < HorizontalAlign.NotSet || value > HorizontalAlign.Justify) {
throw new ArgumentOutOfRangeException("value");
}
ViewState["HorizontalAlign"] = value;
}
}
// 实现IsEmpty
protected new internal bool IsEmpty {
get {
return base.IsEmpty && !IsSet(PROP_BACKIMAGEURL) && !IsSet(PROP_HORIZONTALALIGN) && !IsSet(PROP_WRAP);
}
}
//实现Wrap属性
[ Bindable(true), Category("Layout"), DefaultValue(true), Description("是否允许对所添加的内容换行"), NotifyParentProperty(true) ]
public virtual bool Wrap {
get {
if (IsSet(PROP_WRAP)) { return (bool)ViewState["Wrap"]; }
return true;
}
set { ViewState["Wrap"] = value; }
}
//辅助方法IsSet
internal bool IsSet(int propNumber) {
string key = null;
switch (propNumber) {
case PROP_BACKIMAGEURL: key = "BackImageUrl";
break;
case PROP_HORIZONTALALIGN: key = "HorizontalAlign";
break;
case PROP_WRAP: key = "Wrap";
break;
}
if (key != null) {
return ViewState[key] != null;
}
return false;
}
//重写AddAttributesToRender方法
public override void AddAttributesToRender(HtmlTextWriter writer, WebControl owner) {
if (IsSet(PROP_BACKIMAGEURL)) {
string s = BackImageUrl;
if (s.Length > 0) {
if (owner != null) {
s = owner.ResolveUrl(s);
}
writer.AddStyleAttribute(HtmlTextWriterStyle.BackgroundImage, "url(" + s + ")");
}
}
if (IsSet(PROP_HORIZONTALALIGN)) {
System.Web.UI.WebControls.HorizontalAlign hAlign = this.HorizonalAlign;
if (hAlign != System.Web.UI.WebControls.HorizontalAlign.NotSet) {
TypeConverter hac = TypeDescriptor.GetConverter(typeof(HorizontalAlign));
writer.AddAttribute(HtmlTextWriterAttribute.Align, hac.ConvertToInvariantString(hAlign));
}
}
if (IsSet(PROP_WRAP)) {
bool wrap = Wrap;
if (!Wrap) {
writer.AddAttribute(HtmlTextWriterAttribute.Nowrap, "nowwrap");
}
}
base.AddAttributesToRender(writer, owner);
}
//重写CopyFrom方法
public override void CopyFrom(Style s) {
if (s != null) {
base.CopyFrom(s);
if (s is MyPanelStyle) {
MyPanelStyle mps = (MyPanelStyle)s;
if (!mps.IsEmpty) {
if (mps.IsSet(PROP_BACKIMAGEURL))
this.BackImageUrl = mps.BackImageUrl;
if (mps.IsSet(PROP_HORIZONTALALIGN))
this.HorizonalAlign = mps.HorizonalAlign;
if (mps.IsSet(PROP_WRAP))
this.Wrap = mps.Wrap;
}
}
}
}
// 重写MergeWith方法
public override void MergeWith(Style s) {
if (s != null) {
if (IsEmpty) {
CopyFrom(s);
return;
}
base.MergeWith(s);
if (s is MyPanelStyle) {
MyPanelStyle mps = (MyPanelStyle)s;
if (!mps.IsEmpty) {
if (mps.IsSet(PROP_BACKIMAGEURL) && !this.IsSet(PROP_BACKIMAGEURL))
this.BackImageUrl = mps.BackImageUrl;
if (mps.IsSet(PROP_HORIZONTALALIGN) && !this.IsSet(PROP_HORIZONTALALIGN))
this.HorizonalAlign = mps.HorizonalAlign;
if (mps.IsSet(PROP_WRAP) && !this.IsSet(PROP_WRAP))
this.Wrap = mps.Wrap;
}
}
}
}
//重写Reset方法
public override void Reset() {
base.Reset();
if (IsEmpty) return;
if (IsSet(PROP_BACKIMAGEURL))
ViewState.Remove("BackImageUrl");
if (IsSet(PROP_HORIZONTALALIGN))
ViewState.Remove("HorizontalAlign");
if (IsSet(PROP_WRAP)) ViewState.Remove("Wrap");
}
}
}
下面列举了MyPanelStyle类图。
图3
可能部分读者感觉MyPanelStyle类实现有些复杂,然而,还是有据可寻的。该类的实现严格按照前文所述的类型化样式属性创建方法来进行。
首先,MyPanelStyle类继承了Style类,这是创建类型化样式属性的关键,接着定义了3个属性BackImageUrl、HorizontalAlign和Wrap。这3个属性支持MyPanel中对应的样式属性。然后,代码重写了AddAttributesToRender方法,以便当控件呈现时准确生成相关的HTML和CSS代码。需要注意的是,该方法的第二个参数不可为空,其表示拥有Style对象的具体控件。最后,代码中重写了3个来自Style的方法,CopyFrom、MergeWith和Reset。重写前两个方法是为了复制给定的MyPanelStyle或者把给定的MyPanelStyle与自身合并。这两个方法都调用了基类方法,然后执行自身的逻辑。重写Reset方法主要目的是为了删除添加到ViewState中的属性,它的实现思路与前两个方法差不多,都是调用基类方法,然后执行自身逻辑。
下面列举了为测试MyPanel控件而创建的Default.aspx文件源代码。
<%@ Register TagPrefix="wcl" Assembly="WebControlLibrary" Namespace="WebControlLibrary" %>
<!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 runat="server">
<title>类型化样式属性</title>
</head>
<body>
<form id="form1" runat="server">
<wcl:MyPanel ID="demo1" runat="server" BackImageUrl="pic1.jpg" HorizontalAlign="Center" Height="145" Width="160">
<br />
<br />
这是一行位于MyPanel控件中的文字。
</wcl:MyPanel>
</form>
</body>
</html>
如上代码所示,开发人员可以像使用Panel控件一样,将需要添加的控件设置在MyPanel标签中。这样所设置的控件将自动的显示出来,并且由于MyPanel控件自身的属性设置,其显示的外观和样式将发生相应变化。
小结
本文针对类型化样式属性的实现方法进行了介绍,并且通过一个典型示例加强了读者对于实现方法的理解。在接下来的文章中,我们将继续讨论利用ASP.NET 2.0技术,实现控件客户端功能的内容。
转载于:https://www.cnblogs.com/greateast/archive/2007/01/24/629158.html
ASP.NET2.0服务器控件之类型化样式属性相关推荐
- ASP.NET2.0服务器控件之自定义状态管理
自定义视图状态管理 在介绍视图状态时,我们曾经提到过:对于简单属性,例如,String.Int等类型,.NET执 行引擎将自动启用默认视图状态管理机制,以便完成相应的功能.然而,如果开发人员在View ...
- 一起谈.NET技术,ASP.NET2.0服务器控件之类型转换器
类型转换器是实现自定义服务器控件属性过程中比较重要的内容.本文将对类型转换器的基本概念和实现方法进行介绍. 1. 类型转换器基本概念 类型转换器是自定义服务器控件的辅助性功能实现.它主要用于执行从字符 ...
- ASP.NET2.0自定义控件组件开发 第六章 深入讲解控件的属性
深入讲解控件的属性持久化(一) 系列文章链接: ASP.NET自定义控件组件开发 第一章 待续 ASP.NET自定义控件组件开发 第一章 第二篇 接着待续 ASP.NET自定义控件组件开发 第一章 第 ...
- VS2005 ASP.NET2.0安装项目的制作(包括数据库创建、站点创建、IIS属性修改、Web.Config文件修改)
站点: 如果新建默认的Web安装项目,那它将创建的默认网站下的一个虚拟应用程序目录而不是一个新的站点.故我们只有创建新的安装项目,而不是Web安装项目.然后通过安装类进行自定义操作,创建新站如下图: ...
- ASP.NET2.0 ReportingServices使用详解
ASP.NET2.0 ReportingServices使用详解 作者:清清月儿 主页:http://blog.csdn.net/21aspnet/ 时间:2007.4.9 本文先做 ...
- ASP.NET2.0国际化/本地化应用程序的实现总结(多语言,多文化页面的实现)
相关文章导航 Sql Server2005 Transact-SQL 新兵器学习总结之-总结 Flex,Fms3相关文章索引 FlexAir开源版-全球免费多人视频聊天室,免费网络远程多人视频会议系统 ...
- 【开源】QuickPager ASP.NET2.0分页控件V2.0.0.3 【增加了使用说明】
================================ 欢迎转载,但是请注明出处.本文出自博客园 .谢谢合作! ================================ 最新版本:V ...
- ASP.NET2.0实现无刷新客户端回调
Asp.Net2.0的客户端回调是一种很让人激动的方法,他能够让我们控制要提交什么数据给服务器而不用提交整个页面,同时服务器也只返回你所需要的数据而不要发回整个页面. 首先我们要说一个很重要的方法:G ...
- 【开源】我的分页控件正式命名为QuickPager ASP.NET2.0分页控件
分页控件正式命名为 QuickPager ASP.NET2.0分页控件 . 版本号:2.0.0.1 Framework:.net2.0 分页方式:PostBack .URL (暂时没有实现URL的分页 ...
最新文章
- 关于为何推崇交易规范排序(CTOR)的原因
- 七月在线 《关键点检测概览与环境配置》
- POJ3264 【RMQ基础题—ST-线段树】
- 支付时报错java.lang.RuntimeException: 【微信统一支付】发起支付, returnCode != SUCCESS, returnMsg = appid和mch_id不匹配
- Javascript Asynchonous Progamming
- python中的exec()、eval()以及complie()
- 创建项目连接错误_EF6连接Postgresql数据库
- 《深入理解Java虚拟机》第2版挖的坑终于在第3版中被R大填平了
- 前端开发——图片标注工具
- 【大学物理·光学】光的衍射现象 惠更斯-菲涅耳原理
- f(x)对g(x)求导的理解
- 【Excel】Excel读取数据时,提示“服务器连接异常”
- 曾诗斯老师商务礼仪实战专家
- NTFS的忠实秘书—USN日志
- 试除法解决分解质因数
- 机器学习——监督学习(一)
- MATLAB画三维动态魔方/旋转魔方/旋转立方体
- android 和RxJava配合使用的两个图片压缩框架LuBan、Compressor
- Qt excel 操作使用说明
- Matlab之创建等间隔一维数组
热门文章
- 使用Docker中的mysql
- Android --- android.intent.action.MAIN 与 android.intent.category.LAUNCHER常用的几种情况
- 腐烂国度2巨霸版计算机学知识,《腐烂国度2巨霸版》新手攻略 新手入门玩法技巧大全...
- android编程获取网络和wifi状态及调用网络设置界面,Android编程获取网络连接状态(3G/Wifi)及调用网络配置界面 - Android平台开发技术 - 博客园...
- android 数组赋值字符串_c语言中的字符数组与字符串
- js去除字符串数字前面的0_JS基础复习-七种基本数据类型
- 一套完整的防火墙系统通常是由屏蔽路由器和代理服务器组成
- 不要把为师我说出来就不错了
- 美国政府已关闭 5800 个数据中心,计划关闭 1400 个
- 数据中心空调故障案例集