为ASP.NET 2.0网站生成唯一程序集

在Visual Studio 2003下开发网站的都知道ASP.NET 1.1网站生成后都是一个唯一命名的程序集（项目名称.DLL），但是这种情况在Visual Studio 2005的网站开发中不见了。Visual Studio 2005给我们提供了“发布网站”这样方便的功能，不用在像以前一样COPY的部署，但是采用其“发布网站”的功能，会在站点的BIN目录中产生App_Code.compiled，App_Code.dll，App_Web_xxxxxx.dll，项目名称.dll等等这样的程序集，如果不采用预编译的方式那么产生的文件会更加的多，因为很多都是随机命名也没有什么规律可言；这样会给那些想COPY更新的人带来不便，因为原来的文件不能被覆盖，需要先删除再COPY；有很多时候可能就是更新了后台代码，直接生成项目或是WEB的程序集，像以前一样直接覆盖DLL的方式也很简单。

也许很多人不会考虑BIN下存放的东西，只要站点能运行就好了，那么这样的人读到这里也就没有必要再看此文章，要知道时间是宝贵的，浪费在自己不关心的事情上很不值得的。

上面罗嗦了一堆，下面笔者将介绍采用Microsoft Web Deployment Projects在Visual Studio 2005中生成唯一程序集的方法。

关于Microsoft Web Deployment Projects工具可以从微软站点获得详尽的资料，我也没什么好说的了微软写的很清楚了，呵呵。

下载地址：

http://msdn.microsoft.com/asp.net/reference/infrastructure/wdp/default.aspx

详细使用：

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnaspp/html/web_deployment_projects.asp

 

安装后在“生成”和WEB项目的上下文菜单看到“Add Web Deployment Project…”，好了添加一个Web Deployment Project项目，起一个名称，这个名称就是将来编译后生成的程序集名称，默认的名称“当前项目名称_deploy”

双击Web Deployment Project的项目出现属性页面

Compilation中的Output Folder设置项目输出路径

Output Assemblies中的四大选项：

n        Merge all outputs to a single assembly－所有输出都编译成一个程序集（参数：程序集名称）

n        Treat as library component (remove the App_Code.compiled file)－App_Code视为类库（删除App_Code.compiled文件）

n        Merge each individual folder output to its own assembly－WEB项目中单独的目录会编译到一个程序集中（参数：程序集前缀）

n        Merge all pages and control outputs to a single assembly－所有页面控件编译到一个程序集中（参数：程序集名称）

n        Create a separate assembly for each page and control output－为每一个页面和控件创建程序集

Signing使用key文件建立强命名空间的程序集

Deployment

n        Enable Web.config file section replacement－用不同的config文件替换Web.config中的节点

n        Create an IIS virtual directory for the output folder－创建IIS虚拟目录（参数：虚拟目录名称）

n        Remove the App_Data folder from output location－删除输出目录中的App_Data目录

好了通过简单的设置，就可以生成一个看上去非常“干净利落”的bin目录，每个程序集都很明显，对部分升级工作很有帮助。

2006-6

实际上在我们的一个实际ASP.NET 2.0的解决方案中来应用这种方式出现了问题，下面我就讲一下我的解决过程希望对大家有所帮助。

我们的解决方案包括22个项目（主要是类库），其中的一个WEB项目是负责用户UI的，传统的生成或是发布网站的方式没有任何问题，当使用Web Deployment Projects工具生成唯一程序集时出现了错误信息“Aspnet_merge.exe Exited with Code 1”（Aspnet_merge.exe 退出，错误代码1），这样的信息根本无法让我们办断到底是哪里出了问题。好，下面依次打开VS 2005的工具－选项－项目和解决方案－生成并运行，设置“MSBuild 项目生成输出详细信息”，选择“详细”。再次生成Web Deployment Projects项目，注意“输出”框内的信息现在变得非常丰富了，最后导致无法编译的问题终于出来了“An error occurred when merging assemblies: ILMerge.Merge: ERROR!!: Duplicate type ‘_Default’ found in assembly 'App_Web_k5hhsnh0'”，它的意思是说在程序集中发现了相同的类型_Default，经过我检查确实在我们的WEB项目中存在了两个_Default类（在不同的目录中），这样的问题通过一般的生成完成和发布网站肯定都是检测不出来的，运行也是正常的。VS 2005的WEB项目默认的把命名空间给去掉了，可以手动增加一个命名空间，cs代码中加入namespace的语句块，另外别忘了在aspx文件的<@page>的Inherits中写入对应的[namespace].[类名]；经过这样的操作再次编译成一个程序集就没有问题了（备注：这个项目前后一共发现了5对类名称一致的情况，加上命名空间或是改名称就可以解决了）。

上面就是结合我的项目实际解决的问题，暂时还没有发现别的错误出来。使用有问题的朋友也多多交流。