compilation 的 codeSubDirectories 元素（ASP.NET 设置架构）

.NET Framework 常规参考

更新：2007 年 11 月

定义一个有序子目录集合，这些子目录包含要在运行时编译的文件。

此元素是 .NET Framework 2.0 版中的新元素。

<configuration> 元素
  system.web 元素（ASP.NET 设置架构）
    compilation 元素（ASP.NET 设置架构）
      compilation 的 codeSubDirectories 元素（ASP.NET 设置架构）

<codeSubDirectories>
   <add />
   <clear/>
   <remove /> 
/>

属性和元素

以下几节描述了属性、子元素和父元素。

属性

无。

子元素

元素	说明
add	可选的元素。将子目录添加到子目录集合中，集合中的这些子目录包含要在运行时编译的文件。
clear	可选的元素。移除对继承的子目录名称的所有引用，只允许由当前 add 元素添加的子目录。
remove	可选的元素。从集合中移除对继承的子目录名称的引用。

元素

说明

add

可选的元素。

将子目录添加到子目录集合中，集合中的这些子目录包含要在运行时编译的文件。

clear

可选的元素。

移除对继承的子目录名称的所有引用，只允许由当前 add 元素添加的子目录。

remove

可选的元素。

从集合中移除对继承的子目录名称的引用。

父元素

元素	说明
configuration	指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
system.web	为 ASP.NET 配置节指定根元素。
compilation	配置 ASP.NET 用于编译应用程序的所有编译设置。

备注

codeSubDirectories 元素定义一个经过排序的子目录集合，这些子目录包含要在运行时编译的文件。

子目录名称相对于 App_Code 目录。

从 codeSubDirectories 集合自上而下的顺序可以推断出生成顺序。最后生成 App_Code 目录。但是，不存在生成顺序依赖项，这意味着生成顺序无关紧要。

默认配置

没有为 ASP.NET 配置的默认 codeSubDirectories 元素。

示例

下面的代码示例演示如何定义有序程序集子目录集合。子目录是按编译代码时必须遵循的顺序列出的，这一顺序就是代码依赖项的作用。

<configuration>
   <system.web>
      <compilation>
         <codeSubDirectories>
           <add directoryName="mySubDir1"/>
           <add directoryName="mySubDir2"/>
           <add directoryName="mySubDir3"/>
         </codeSubDirectories>
      </compilation>
   </system.web>
</configuration>

元素信息

配置节处理程序	CompilationSection
配置成员	CodeSubDirectories CodeSubDirectoriesCollection
可配置的位置	Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config
要求	Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005

请参见

属性

子元素

父元素

默认配置

任务

概念

参考

其他资源