把aspx文件编译成DLL文件
2024-05-04 11:06:23
供稿：网友
注册会员，创建你的web开发资料库，前言
asp.net不是asp的简单升级，而是微软.net计划中的一个重要组成部分，它依托.net的多语言与强大的类库支持，引进了服务端html控件与web控件，自动处理控件的客户端与服务端的 交互，为开发人员提供了类似windows下窗口编程的界面，为开发大型网络应用程序功能提供了良好的编程接口，也能够极大地提高开发人员的工作效率。
然而，“一次转换，两次编译”过程使得aspx文件在首次执行（或更新后首次运行）时显得略有不足，特别是在拥有大量aspx及codebehind的代码文件的应用环境中，把aspx文件编译成dll（在.net中，被称为应用程序集）后再发布，省去“一次转换、一次编译”的时间及cpu占用率，对提高web服务的整体性能会有较大的提升。当然，编译成dll后，对源代码的保密性也有一定程度的提高。
本文通过对asp.net的基本处理流程及一个偶然发现的秘密的分析，介绍了在asp.net中如何建立aspx到dll的映射，如何开发一个可以处理http请求/响应的dll，以及如何设置“陷阱”，把现成的单个aspx文件与codebehind的aspx文件编译成dll的过程，文章最后，还介绍了一个在实际操作过程的小技巧。
由于本文要涉及asp.net应用程序、命令行编译、web.config配置文件等概念，为了使读者能更好地理解本文内容，也为了使本文看上去不显累赘，先就本文相对应的系统环境作一介绍：
系统环境：
win2000（sp3）+ iis5 + .net framework 1.0（中文版）。
服务器名称：
由于本文的例子均在本机上测试，服务器名称为localhost。
iis设置：
建立虚拟目录dlltest（真实路径为w:/wwwroot/dlltest），并把它设为应用程序，在dlltest下建立bin目录。所有源文件将放在dlltest目录下，而所有dll文件将放在dlltest/bin目录下。
asp.net应用程序配置文件--web.config
在dlltest目录下建立一个web.config文件，初始时该文件内容如下：
<?xml version="1.0"?>
<configuration>
<system.web />
</configuration>
命令窗口（dos窗口）
打开命令窗口，并用cd命令使当前目录为w:/wwwroot/dlltest。
一、建立aspx到dll的映射
首先让我们来看看一般情况下aspx文件是如何被asp.net处理的：
当一个http请求（例如“http://webserver/webapp/webpage.aspx”）从客户端发送到iis服务器时，iis捕获并分析这个请求，当它分析到这个请求是一个aspx页面时，立即以“/webapp/webpage.aspx”为参数调用asp.net运行环境（aspnet_wp.exe）,asp.net环境启动后，检查“/webapp/webpage.aspx”是否存在，若不存在，则向客户端返回http 404(file not found)错误，否则在asp.net 的临时目录中查找相应的dll文件，若不存在或者该dll比aspx源文件“旧”，则调用csc编译器（若aspx的服务端脚本语言是vb或jscript，则调用相应的vbc编译器, jsc编译器）把aspx文件编译成dll，然后asp.net再调用该dll来处理具体的客户请求，返回服务器响应。
从这个处理流程可以看出，一般情况下，asp.net运行环境会自动识别、检查、更新与aspx相对应的dll。那么有没有其它办法可以强制把对一个aspx文件的处理“路由”到一个已编译存在的dll呢？方法就是在asp.net应用程序配置文件web.config的system.web节的httphandlers节添加aspx到dll的映射项，语法如下：
<add verb="*" path="aspx文件名" type="类名,dll文件" />
aspx文件：需要被“路由”的虚拟名称，扩展名必须是aspx，否则iis会先于asp.net运行环境处理该文件。
dll文件： dll文件（应用程序集）的名称，不必输入“.dll”。asp.net 首先在应用程序的专用 /bin 目录中搜索程序集 dll，然后在系统程序集缓存中搜索程序集 dll。
类名： 由于一个dll可能会有多个名称空间或多个类，因此必须指明当dll调用时自动加载哪个类。
例如，某一asp.net应用程序的web.config文件如下：
<?xml version="1.0"?>
<configuration>
<system.web>
<httphandlers>
<add verb="*" path="index.aspx" type="bbs.indexpage, bbs" />
</httphandlers>
</system.web>
</configuration>
该配置文件告诉asp.net，在客户端请求本应用程序的index.aspx文件时，直接调用应用程序bin目录下的bbs.dll，并自动加载其中的bbs.indexpage类。
二、开发能处理html页面的dll
应该指出的是，并不是所有的应用程序集dll都能实现http请求/响应模式。还是来看一下microsoft asp.net快速入门教程(http://chs.gotdotnet.com/quickstart/aspplus/)中关于“http 处理程序和工厂”的描述：
asp.net 提供低级别的请求/响应 api，使开发人员能够使用 .net 框架类为传入的 http 请求提供服务。为此，开发人员需创作支持 system.web.ihttphandler 接口和实现 processrequest() 方法的类。当处理 http 请求不需要由高级别的页框架抽象化提供的服务时，处理程序通常很有用。处理程序的常用用途包括筛选器和类似 cgi 的应用程序，尤其是那些返回二进制数据的应用程序。
asp.net 收到的每个传入 http 请求最终由实现 ihttphandler 的类的特定实例来处理。ihttphandlerfactory 提供了处理 ihttphandler 实例 url 请求的实际解析的结构。除了 asp.net 提供的默认 ihttphandlerfactory 类外，开发人员还可以选择创建和注册工厂以支持大量的请求解析和激活方案。
从这段文字可以看出，当aspx页面不涉及.net框架提供的高级界面技术（如数据缓存、状态保持、web窗体控件引用等等）时，且向客户端输出的不是复杂的html文本，特别是只向客户端返回二进制数据（如图片，声音等）时，可以用一个.cs应用程序文件（本文使用c#语言，如果是用vb或jscript，...）来替代，而该应用程序必须有一个实现system.web.ihttphandler 接口和并实现 processrequest() 方法的类。一个简单的例子如下：
/* 源文件：ex1.cs 开始 */
using system.web;
namespace dlltest
{
/*
类必须实现ihttphandler接口。如果程序将访问会话状态（session），则必须实现 irequiressessionstate 接口（不包含任何方法的标记接口）。
*/
public class ex1page : ihttphandler
{
/*
isreusable属性告诉.net框架，本程序是否可以被多个线程同时使用。
true对应是；false对应否。
*/
public bool isreusable
{
get { return true; }
}
/*
实现processrequest方法，向客户端返回响应数据。
本例中向客户端返回一个简单的html页面
*/
public void processrequest(httpcontext context)
{
httpresponse res = context.response;
res.write("<html><body>");
res.write("<h1>dlltest - ex1（例1）</h1><hr>");
res.write("本页面直接由dll处理");
res.write("</html></body>");
}
}
}
/* 源文件：ex1.cs 结束 */
在命令行状态，用如下的编译命令把ex1.cs编译成ex1.dll，并把它存放在bin目录下。
csc /t:library /out:bin/ex1.dll ex1.cs
在配置文件web.config中添加aspx->dll映射，添加后，web.config应该是这样子的：
<?xml version="1.0"?>
<configuration>
<system.web>
<httphandlers>
<add verb="*" path="dlltest1.aspx" type="dlltest.ex1page, ex1" />
</httphandlers>
</system.web>
</configuration>
现在当浏览器访问http://localhost/dlltest/dlltest1.aspx时，实际上就是调用了ex1.dll中dlltest.ex1page类的processrequest方法，在浏览中应该可以看到一个简单的页面。
三、把单个aspx文件编译成dll
从上一节微软公开描述的“言外之意”来看，微软是不支持让开发人员直接把aspx文件编译成dll的。然而，asp.net高级界面技术（服务端html控件，web控件等等）都是需要通过aspx文件才能展现出来的，如果为了dll的运行效率而放弃aspx的高级特性，则显然是得不尝失的。
现在静下心来分析一下：
csc编译器只是一个c#语言的编译器，它只能对符合c#语言规范的文件进行编译，而aspx文件的格式显然不符合c#语言规范，所以csc编译器是无法对aspx源文件进行编译的。
因此，要想把aspx文件编译成dll文件，必然要先把aspx文件转化成csc编译器能识别的cs源文件。那么用什么工具来进行转换呢？虽然我深信这个工具一定是隐藏在.net framework里面，但在查阅了大量的asp.net及.net的公开文档及参考手册，资料之后，仍找不到相关资料。
呵呵，天无绝人之路，一个偶然的机会，还是让我发现了这个秘密。
来看看源文件ex2.aspx:
/* 源文件：ex2.aspx 开始 */
<%@ page language="c#" %>
<script runat="server">
/*
你没看错，下一行就是“abcdefg”，正是这一行，才让我有机会写出本篇文章^_^；
在文中，我把这一行称作“代码陷阱”
*/
abcdefg // 代码陷阱
void page_load(object src, eventargs args)
{
if( !ispostback ) notelabel.text = "请输入您的姓名：";
}
void onnamesubmit(object src, eventargs args)
{
string name = f_name.value;
notelabel.text = (name=="") ? "姓名不能为空" : name +"，您好。欢迎光临！";
}
</script>
<html>
<body>
<form runat="server">
<h1>dlltest - ex2（例2）</h1>
<hr>
<asp:label runat="server" id="notelabel" style="color:red; font-weight:bold" />
<input runat="server" id="f_name" size="8">
<button runat="server" onserverclick="onnamesubmit">确定</button>
</form>
</body>
</html>
/* 源文件：ex2.aspx 结束 */
如果把“代码陷阱”注释掉或删掉，那么ex2.aspx就是一个简单的asp.net文件，用ie浏览此页面可以发现它能正常工作。
现在让我们打开“陷阱”，来看看asp.net到底返回了什么？
返回的是一个“编译错误”的页面，报告源文件无法通过编译。让我们感兴趣的是该页面最下方的一个名为“显示完整的编译源”的超链接，点击些链接，就能看到这个由ex2.aspx转换而来的cs源文件（“完整的编译源”）的完整内容。把这部分“完整的编译源”去掉前面的行号信息和其它的一些编译开关（主要是#line编译命令），并关闭那个可爱的“代码陷阱”（用//把它注释掉或直接把它delete也行），整理后保存为ex2_aspx.cs：
/* 源文件：ex2_aspx.cs 开始 */
/*
从下面的说明可以看出，确实有一个未公开的工具来完成把aspx文件转化成cs源文件
*/
//------------------------------------------------------------------------------
// <autogenerated>
// this code was generated by a tool.
// runtime version:1.0.3705.0
//
// changes to this file may cause incorrect behavior and will be lost if
// the code is regenerated.
// </autogenerated>
//------------------------------------------------------------------------------
/*
奇怪的是：命名空间居然是asp而不是aspx
建议把该名称改成适合应用程序的名称，防止命名冲突，例如针对本文，可以改成dlltest
这里没改是为了让大家看清它的原貌
*/
namespace asp {
using system;
using system.collections;
using system.collections.specialized;
using system.configuration;
using system.text;
using system.text.regularexpressions;
using system.web;
using system.web.caching;
using system.web.sessionstate;
using system.web.security;
using system.web.ui;
using system.web.ui.webcontrols;
using system.web.ui.htmlcontrols;
/*
1、注意一下类名的构成，如果必要，可以把它改成有意义的名称，例如针对本文，可以改成ex2page
2、注意它的基类。syste.web.ui.page实现了ihttphandler接口，由于要访问session，所以也实现了irequiressessionstate接口。
*/
public class ex2_aspx : system.web.ui.page, system.web.sessionstate.irequiressessionstate {
private static int __autohandlers;
protected system.web.ui.webcontrols.label notelabel;
protected system.web.ui.htmlcontrols.htmlinputtext f_name;
protected system.web.ui.htmlcontrols.htmlbutton __control3;
protected system.web.ui.htmlcontrols.htmlform __control2;
private static bool __intialized = false;
private static system.collections.arraylist __filedependencies;
/* 现在可以关掉“陷阱”了 */
// abcdefg
void page_load(object src, eventargs args)
{
if( !ispostback ) notelabel.text = "请输入您的姓名： ";
}
void onnamesubmit(object src, eventargs args)
{
string name = f_name.value;
notelabel.text = (name=="") ? "姓名不能为空" : name +"，您好。欢迎光临！";
}
/* 构造函数 */
public ex2_aspx() {
system.collections.arraylist dependencies;
if ((asp.ex2_aspx.__intialized == false)) {
dependencies = new system.collections.arraylist();
/*
应该把下面这行注释掉，让dll成为一个无依赖的独立文件
防止在dll运行时再次去查找、比较它的“依赖”文件的新旧
*/
//dependencies.add("w://wwwroot//dlltest//ex2.aspx");
asp.ex2_aspx.__filedependencies = dependencies;
asp.ex2_aspx.__intialized = true;
}
}
protected override int autohandlers {
get {
return asp.ex2_aspx.__autohandlers;
}
set {
asp.ex2_aspx.__autohandlers = value;
}
}
protected system.web.httpapplication applicationinstance {
get {
return ((system.web.httpapplication)(this.context.applicationinstance));
}
}
public override string templatesourcedirectory {
get {
return "/dlltest";
}
}
private system.web.ui.control __buildcontrolnotelabel() {
system.web.ui.webcontrols.label __ctrl;
__ctrl = new system.web.ui.webcontrols.label();
this.notelabel = __ctrl;
__ctrl.id = "notelabel";
((system.web.ui.iattributeaccessor)(__ctrl)).setattribute("style", "color:red; font-weight:bold");
return __ctrl;
}
private system.web.ui.control __buildcontrolf_name() {
system.web.ui.htmlcontrols.htmlinputtext __ctrl;
__ctrl = new system.web.ui.htmlcontrols.htmlinputtext();
this.f_name = __ctrl;
__ctrl.id = "f_name";
__ctrl.size = 8;
return __ctrl;
}
private system.web.ui.control __buildcontrol__control3() {
system.web.ui.htmlcontrols.htmlbutton __ctrl;
__ctrl = new system.web.ui.htmlcontrols.htmlbutton();
this.__control3= __ctrl;
system.web.ui.iparseraccessor __parser = ((system.web.ui.iparseraccessor)(__ctrl));
__parser.addparsedsubobject(new system.web.ui.literalcontrol("确定"));
__ctrl.serverclick += new system.eventhandler(this.onnamesubmit);
return __ctrl;
}
private system.web.ui.control __buildcontrol__control2() {
system.web.ui.htmlcontrols.htmlform __ctrl;
__ctrl = new system.web.ui.htmlcontrols.htmlform();
this.__control2= __ctrl;
system.web.ui.iparseraccessor __parser = ((system.web.ui.iparseraccessor)(__ctrl));
__parser.addparsedsubobject(new system.web.ui.literalcontrol("/r/n <h1>dlltest - ex2（例2）</h1>/r/n <hr>/r/n "));
this.__buildcontrolnotelabel();
__parser.addparsedsubobject(this.notelabel);
__parser.addparsedsubobject(new system.web.ui.literalcontrol("/r/n "));
this.__buildcontrolf_name();
__parser.addparsedsubobject(this.f_name);
__parser.addparsedsubobject(new system.web.ui.literalcontrol("/r/n "));
this.__buildcontrol__control3();
__parser.addparsedsubobject(this.__control3);
__parser.addparsedsubobject(new system.web.ui.literalcontrol("/r/n "));
return __ctrl;
}
private void __buildcontroltree(system.web.ui.control __ctrl) {
system.web.ui.iparseraccessor __parser = ((system.web.ui.iparseraccessor)(__ctrl));
__parser.addparsedsubobject(new system.web.ui.literalcontrol("/r/n/r/n<html>/r/n<body>/r/n "));
this.__buildcontrol__control2();
__parser.addparsedsubobject(this.__control2);
__parser.addparsedsubobject(new system.web.ui.literalcontrol("/r/n</body>/r/n</html>/r/n"));
}
protected override void frameworkinitialize() {
this.__buildcontroltree(this);
this.filedependencies = asp.ex2_aspx.__filedependencies;
this.enableviewstatemac = true;
}
public override int gettypehashcode() {
return -11574299;
}
}
}
/* 源文件：ex2_aspx.cs 结束 */
相信大家在分析了这个文件之后，会对asp.net运行原理有更进一步的认识（与本文无关，不详述）。
在命令行状态，用如下的编译命令把ex2_aspx.cs编译成ex2.dll，并把它存放在bin目录下。
csc /t:library /out:bin/ex2.dll ex2_aspx.cs
在配置文件web.config中添加aspx->dll映射，即在system.web节的httphandlers添加下面一行：
<add verb="*" path="dlltest2.aspx" type="asp.ex2_aspx, ex2" />
现在当浏览器访问http://localhost/dlltest/dlltest2.aspx时，就如同访问ex2.aspx一样。当然，现在即使ex2.aspx不存在，或者已经更新过，也不会对页面访问有任何影响，除非重新生成bin/ex2.dll。
四、把codebehind的aspx文件编译成dll
对于把codebehind的aspx文件编译成dll，其中把aspx文件转化成cs源文件的原理同上，也是先设置一个“代码陷阱”，然后把“完整的编译源”进行适当整理，保存为cs源文件。区别是在编译成dll时的步骤：（为叙述方便，假设界面文件为ex3.aspx，codebehind文件为ex3.aspx.cs，ex3.aspx的“完整编译源”保存为ex3_aspx.cs）
第一步：先用如下命令把ex3.aspx.cs编译成bin/ex3.aspx.cs.dll
csc /t:library /out:bin/ex3.aspx.cs.dll ex3.aspx.cs
第二步：再用如下命令把ex3_aspx.cs编译成bin/ex3.dll
csc /t:library /r:bin/ex3.aspx.cs.dll /out:bin/ex3.dll ex3_aspx.cs
然后在配置文件web.config中添加aspx->dll映射，即在system.web节的httphandlers添加下面一行：
<add verb="*" path="dlltest3.aspx" type="asp.ex3_aspx, ex3" />
现在打开浏览器，访问http://localhost/dlltest/dlltest3.aspx试试。
五、一点小技巧
在设置“陷阱”把aspx文件转化成cs源文件时，一般是使用copy、paste方法把“完整的编译源”保存在记事本或vs.net或其它asp.net开发环境，再进行整理后保存为cs源文件的。
整理，就是把paste进来的行号信息与“#line”编译指令去掉。如果是手动地删掉这些信息，则会太麻烦，即使是一个简单的如ex2.aspx的文件，也会产生约270行的“完整的编译源”。
我所使用的一个小技巧是：在记事本里，用替换的方法来快速整理。用"/* 行"来全部替换"行"，用"：*/"来全部替换"："，用"// #line 行"来全部替换"#line"，替换完成之后，再把“代码陷阱”注释掉，把主类构造函数里设置“依赖文件”的语句全部注释掉，这样就算整理完成了。
