《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

在Visual Studio中开发Web项目,Web 窗体页由两部分组成:视觉元素(HTML、服务器控件和静态文本)和该页的编程逻辑。 一般将这两个组成部分分别存储在一个单独的文件中。可视元素在一个 .aspx 文件中创建,而代码位于一个单独的类文件中(.aspx.vb 或 .aspx.cs)。或者有时候也会在同一文件中创建视觉元素和代码。

而在Asp.Net Forums的Web窗体页中没有找到我们熟悉的.aspx.cs文件,也没有发现任何C#代码,取而代之是一个个控件,代码在哪里?!

下面将以login.aspx为例详细说明Asp.Net Forums是如何实现代码分离和换皮肤的:
首先我们看看login.aspx在两种皮肤样式下的运行效果
(Theme:default)(Theme:ElectricMidnight)

只是更改了一下Asp.Net Forums的默认皮肤,同样是Login.aspx,显示的是两种不同的皮肤样式。先回想一下VS.Net中,先不论换皮肤功能,如果我们要实现一个登陆页面,那么我们在Aspx或Ascx页中将输入帐号密码的TextBox、登陆的Button拖入,在编辑区双击Button,写上对Button点击事件处理的代码,多么方便,大部分代码都由VS.Net为我们完成了。

我们再来看Login.aspx的源码:

<%@ Import Namespace="AspNetForums.Components" %>
<%@ Register TagPrefix="Forums" Namespace="AspNetForums.Controls" Assembly="AspNetForums.Controls" %>
<%@ Register TagPrefix="mp" Namespace="MetaBuilders.WebControls.MasterPages" Assembly="MetaBuilders.WebControls.MasterPages" %>

<mp:ContentContainer runat="server" id="MPContainer" MasterPageFile="~/Themes/MasterPage.ascx">
<mp:Content id="MainContent" runat="server">
<p align="center">
<Forums:NavigationMenu DisplayTitle="true" id="Navigationmenu1" runat="server" />
<br />
<br />
<br />
<Forums:Login runat="server" id="PostView1" />
</p>
</mp:Content>
</mp:ContentContainer>
注:其中 <mp:***> ,这个是一个第三方控件,其目的是为了保证界面的一致性,提取页面间的重复代码。

从源码中我们没有看到任何构成Login.aspx页面效果的TextBox、Button等基本元素。甚至没有发现一行C#代码,不过如果您对页面控件比较熟悉不难发现原来Asp.Net Forums中将登陆的界面封装为了控件(在此对页面控件并不作专门介绍,如果您对控件相关知识还比较陌生的话,强烈推荐您查阅相关资料或书籍)。 原来登陆界面的实现就是在<Forums:Login runat="server" id="PostView1" />控件中,从
<%@ Register TagPrefix="Forums" Namespace="AspNetForums.Controls" Assembly="AspNetForums.Controls" %>
我们可以知道Login控件对应的类应该为:AspNetForums.Controls.Login,在VS.Net中,切换到类视图,找到AspNetForums.Controls.Login并转到对应文件:

(该图告诉您如何快速的查找控件对应的文件)
 

从代码中看到的该控件是从SkinnedForumWebControl类继承的:

public class Login : SkinnedForumWebControl {  // 从 SkinnedForumWebControl 基类继承
    ......
}

我们还是先看看基类SkinnedForumWebControl。
using System;
using System.Drawing;
using System.Collections;
using System.Collections.Specialized;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using AspNetForums;
using AspNetForums.Components;
using System.ComponentModel;
using System.IO;
using System.Web.Security;
using AspNetForums.Enumerations;

namespace AspNetForums.Controls {

[
ParseChildren(true)
]
/// <summary>
/// 几乎Asp.Net Forums中所有控件的基类,继承自WebControl,并实现INamingContainer接口
/// </summary>

public abstract class SkinnedForumWebControl : WebControl, INamingContainer {

    ForumContext forumContext = ForumContext.Current;
    string skinFilename = null;
    string skinName = null;
    string returnURL = null;
    ForumMode mode = ForumMode.User;


    public SkinnedForumWebControl() {

    // 使用的皮肤——如果是匿名用户,则使用系统默认样式
    //

    if (forumContext.User.IsAnonymous) {
    skinName = Globals.Skin;
    }
    else
{
    skinName = forumContext.User.Theme;
    }

}



/// <summary>
/// 当开发复合服务器控件或模板服务器控件时,必须重写此方法。
/// 通知使用基于合成的实现的服务器控件创建它们包含的任何子控件,以便为回发或呈现做准备。
/// </summary>

protected override void CreateChildControls() {
    Control skin;

    // 装载用户控件
    skin = LoadSkin();

    // 初始化控件
    InitializeSkin(skin);

    Controls.Add(skin);
}


/// <summary>
/// 通过SkinName和SkinFilename找出用户控件文件的路径,装载该用户控件后的Control对象
/// </summary>
/// <returns></returns>

protected Control LoadSkin() {
    Control skin;
    // 用户控件文件所在位置
    string skinPath = Globals.GetSkinPath() + "/Skins/" + SkinFilename.TrimStart('/');
    string defaultSkinPath = Globals.ApplicationPath + "/Themes/default/Skins/" + SkinFilename.TrimStart('/');

    // 必须要有SkinFilename属性
    if (SkinFilename == null)
        throw new Exception("You must specify a skin.");

    // 从用户控件文件获取 UserControl 对象。
    try {
    skin = Page.LoadControl(skinPath);
    }
    catch (FileNotFoundException) {

        // 如果没有找到指定皮肤的用户控件文件,装载默认皮肤下的控件文件
        try {
            skin = Page.LoadControl(defaultSkinPath);
        }
        catch (FileNotFoundException) {
            throw new Exception("Critical error: The skinfile " + skinPath + " could not be found. The skin must exist for this control to render.");
        }
    }
    return skin;
}

/// <summary>
/// 初始化控件,并绑定控件数据
/// </summary>
/// <param name="skin"></param>

protected abstract void InitializeSkin(Control skin);

/// <summary>
/// 用户控件文件(*.ascx)路径
/// </summary>

public string SkinFilename {
    get {
        return skinFilename;
    }
    set {
        skinFilename = value;
    }
}


/// <summary>
/// 皮肤名
/// </summary>

protected string SkinName {
    get {
        return skinName;
    }
    set {
        skinName = value;
    }
}

public ForumMode Mode {
    get { return mode; }
    set { mode = value; }
}

}
}
 
从代码中可以看出,基类SkinnedForumWebControl继承自WebControl类并实现了INamingContainer接口。既然是自定义控件,自然就是从WebControl类继承。之所以实现INamingContainer接口,是因为在开发模板化控件时,应实现该接口以避免同一页上的命名冲突。

在SkinnedForumWebControl中有两个重要的属性:SkinName 和 SkinFilename,分别表示皮肤名和用户控件文件路径。在Asp.Net Forums2.0中,在Web目录下有一个Themes目录,每种皮肤对应一个目录,例如default、ElectricMidnight,每个皮肤文件夹下有三个文件夹:image、Skins和style,分别用来存放该皮肤下对应的图片文件、用户控件文件(*.ascx)和样式表Css文件。通过这两个属性,我们可以知道用户控件文件(*.ascx)的真实路径,例如我们的SkinName是default,SkinFilename是skin-login.ascx,那么用户控件的路径是Themes/default/skins/skin-login.ascx,同理,如果我们将皮肤样式换成ElectricMidnight,那么用户控件的路径将是 Themes/ElectricMidnight/skins/skin-login.ascx。

还有两个重要的方法,一个是LoadSkin(),在该方法中,首先根据上面介绍的两个属性找出用户控件文件的路径,然后通过Page.LoadControl(defaultSkinPath)方法,从用户控件文件中获取 UserControl 对象。这也就是为什么皮肤不同,页面样式就不同,因为随着皮肤的不同,我们Load的用户控件文件也不同,我们只要将用户控件文件样式设置的不一样,就可以随着皮肤的不同显示的样式也不一样。
 

 

但是光这些还不够,我们还需要识别ascx页中的页面控件。例如在skin-login.ascx中,我们必须知道哪个输入框是帐号的,那个输入框是密码的,知道用户是否点击了登陆按钮。回想VS.Net中,IDE自动帮我们把这些控件根据ID识别出来,在IDE中双击按钮,就可以直接加上响应点击事件的代码,多么方便。但是现在我们该如何?……

基类中还有一个抽象的InitializeSkin(Control skin)方法,所有继承自SkinnedForumWebControl的控件都必须override该方法,因为我们可以在这个方法中来初始化控件,在LoadSkin()方法中我们已经通过Page.LoadControl(defaultSkinPath)方法返回了一个UserControl,现在我们在InitializeSkin(Control skin)中通过Control.FindControl 方法,在UserControl中搜索指定的服务器控件,并对控件进行绑定数据和事件。还是以Login控件为例,摘取AspNetForums.Controls.Login类中的部分代码如下:

public class Login : SkinnedForumWebControl {  // 从 SkinnedForumWebControl 基类继承
    string skinFilename = "Skin-Login.ascx";    // 默认皮肤文件
    TextBox username;    // 帐号输入框
    TextBox password;    // 密码输入框
    Button loginButton;  // 登陆按钮
}
public Login() : base() {
    if (SkinFilename == null)
    SkinFilename = skinFilename;    // 定义默认的皮肤文件
}

// 重写 InitializeSkin 初始化
override protected void InitializeSkin(Control skin) {

    // 查找ascx页中ID是username的textbox控件
    username = (TextBox) skin.FindControl("username");

    // 查找ascx页中ID是password的textbox控件
    password = (TextBox) skin.FindControl("password");

    // 找到登陆按钮
    loginButton = (Button) skin.FindControl("loginButton");
    loginButton.Click += new System.EventHandler(LoginButton_Click);    // 绑定登陆按钮的Click事件
    loginButton.Text = ResourceManager.GetString("LoginSmall_Button");

}

在skin-login.ascx中,我们的每个控件都有一个ID,例如用户名输入框的ID是username,这样,我们就可以在重写InitializeSkin(Control skin)的时候,利用username = (TextBox) skin.FindControl("username");这样的方法来一个个找到对应用户控件文件中的控件。并可以对绑定数据和事件,例如:loginButton.Click += new System.EventHandler(LoginButton_Click),绑定登陆按钮的Click事件。

综上所述,Asp.Net Forums就是通过自定义控件来实现代码分离的,并通过在控件中动态装载用户控件文件(*.aspx)来实现换皮肤功能的。当您在看Asp.Net Forums2.0源代码的时候,再也不要被<Forums:NavigationMenu DisplayTitle="true" id="Navigationmenu1" runat="server" />这样的代码所吓倒,直接切换到类视图,找到对应的类:AspNetForums.Controls.NavigationMenu,从类代码中……

如果您还不是很理解,您可以自己研读一下Asp.Net Forums2.0的源码,如果您觉得太复杂,请看模拟Asp.Net Forums实现可以换皮肤的控件一文的例子,也许有助您理解:)

发表于 2004年5月28日 8:43

评论

# re: 《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

讲得太好了,谢谢!
2004-5-28 13:53 | jiangyu

# re: 《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

严重佩服您的技术,更佩服您的共享精神,您一定会更有成就的!祝福您!愿成为您的朋友!

QQ:9842766
2004-6-22 23:56 | jlzhou

# re: 《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

了不起!
2004-7-7 11:04 | Numby

# re: 《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

代码是看懂了,但感觉无法熟练应用到自己的项目中
2004-7-14 11:17 | xiaoqiao

# re: 《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

代码是看懂了,但感觉无法熟练应用到自己的项目中
QQ:2220911
2004-7-14 11:17 | xiaoqiao

# re: 《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

你好,我一直在寻找代码与显示页面分离的方法,在这个过程中碰到了一些问题,在百度上搜索到这里,想请你指教一下,在这里先谢谢你了!

问题是这样的:
我用代码隐藏的方式可以做到控制调用页面的控件如一个ID为test_1的Label控件,进行赋值,但是把这个代码文件编译成DLL就不行了,为什么呢?我想一定有些地方我是理解错了。
2004-8-23 8:36 | jdeasy

# re: 《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

可能是你调用方法不对,例如:
<%@ Register TagPrefix="Forums" Namespace="AspNetForums.Controls" Assembly="AspNetForums.Controls" %>
<Forums:CreateEditPost runat="server"/>

Assembly属性就是表示dll的名称
2004-8-23 20:50 | 宝玉

# re: 《Asp.Net Forums2.0深入分析》之 Asp.Net Forums是如何实现代码分离和换皮肤的

我的代码是这样的:

显示页面:
<%@ Page Language="VB" runat="server" ResponseEncoding="gb2312" %>
<%@ Register TagPrefix="test_1" Namespace="test1" Assembly="test1" %>
<test_1:Class2 id="mytest" runat="server" />
<form runat="server" >
<Asp:Label id="labtest1" runat="server" />
</form>

test1.dll的源代码(vb)如下:
Imports System
Imports System.Web
Imports Microsoft.VisualBasic
Imports System.Web.UI
Imports System.Web.UI.Page
Imports System.web.UI.WebControls
Imports System.Data
Imports System.Data.OleDb
Imports System.ComponentModel
Imports System.Configuration

Namespace test1

Public Class Class2 : Inherits Control : Implements INamingContainer

Protected labtest1 As System.Web.UI.Webcontrols.Label
#Region " Web 窗体设计器生成的代码 "

'该调用是 Web 窗体设计器所必需的。
<System.Diagnostics.DebuggerStepThrough()> Private Sub InitializeComponent()

End Sub

Private Sub Page_Init(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Init
'CODEGEN: 此方法调用是 Web 窗体设计器所必需的
'不要使用代码编辑器修改它。
InitializeComponent()
End Sub

#End Region

Public Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
labtest1.text="hello"
End Sub

End Class

End Namespace

如果去掉命名空间,用
<%@ Page Language="VB" runat="server" Inherits="class2" src="test1.vb" %>这样的方式是可以控制的。
我想,是不是用了命名空间之后,就不可以直接控制原页面上的控件了?
posted @ 2006-04-05 19:04  叶晓丰  阅读(933)  评论(0编辑  收藏  举报