CompilationSection 类

配置 ASP.NET 应用程序的编译设置。

语法

class CompilationSection : ConfigurationSectionWithCollection  

方法

下表列出了 CompilationSection 类公开的方法。

名称 说明
添加 (继承自 ConfigurationSectionWithCollection。)
清除 (从 ConfigurationSectionWithCollection 继承。)
Get (从 ConfigurationSectionWithCollection 继承。)
GetAllowDefinition (继承自 ConfigurationSection。)
GetAllowLocation (从 ConfigurationSection 继承。)
删除 (从 ConfigurationSectionWithCollection 继承。)
RevertToParent (从 ConfigurationSection 继承。)
SetAllowDefinition (从 ConfigurationSection 继承。)
SetAllowLocation (从 ConfigurationSection 继承。)

属性

下表列出了 CompilationSection 类公开的属性。

名称 描述
Assemblies 一个 AssemblySettings 值,该值包含在编译 ASP.NET 应用程序时使用的程序集引用。 ASP.NET 在编译每个代码模块时自动将这些程序集链接到资源。 注意:此属性是 .NET Framework 2.0 中的新属性。
AssemblyPostProcessorType 一个读/写 string 值,该值指定程序集的后处理编译步骤。 注意:此属性是 .NET Framework 2.0 中的新属性。
Batch 一个读/写 boolean 值。 如果 ASP.NET 在批处理模式下预编译所有未编译的文件,则为 true;否则,为 false。 默认为 true

将此属性设置为 true,以更改访问未编译文件时因进行必需编译而导致的延迟。 首次编译文件时会出现延迟;但文件经编译后,延迟会被消除。 注意:此属性是 .NET Framework 2.0 中的新属性。
BatchTimeout 一个读/写 datetime 值,该值指定允许进行批量编译的时间(以秒为单位)。 默认值为 900。

如果在超时时间内无法完成编译,则编译器会还原为当前页面的单次编译模式。 注意:此属性是 .NET Framework 2.0 中的新属性。
BuildProviders 一个 BuildProviderSettings 值,该值编译特定文件类型的自定义资源文件并在编译过程中生成代码。 注意:此属性是 .NET Framework 2.0 中的新属性。
CodeSubdirectories 一个 DirectorySettings 值,该值指定包含要在运行时编译的文件的子目录。 子目录名称基于 App_Code 目录。 生成顺序是根据 CodeSubDirectories 集合自上而下的顺序推断的。 App_Code 目录在最后生成。 但不存在生成顺序依赖性,这意味着生成顺序并不重要。 注意:此属性是 .NET Framework 2.0 中的新属性。
Debug 一个读/写 boolean 值。 如果通过编译创建的二进制文件是调试二进制文件,则为 true;如果使用发布二进制文件进行编译,则为 false。 默认为 false注意:此属性是 .NET Framework 2.0 中的新属性。
DefaultLanguage 一个读/写 string 值,该值指定要在动态编译文件中使用的默认编程语言,例如 C# 或 Visual Basic。 默认值为“vb”,该值指定 Visual Basic。

语言名称在 Machine.config 文件的 <system.codedom> 部分中定义。 注意:此属性是 .NET Framework 2.0 中的新属性。
Explicit 一个读/写 boolean 值。 如果启用了 Visual Basic 显式编译选项,则为 true;否则,为 false。 默认为 true注意:此属性是 .NET Framework 2.0 中的新属性。
ExpressionBuilders 一个 ExpressionBuilderSettings 值,该值指定编译期间要使用的资源字符串。 资源字符串将前缀与表达式生成器相关联。 注意:此属性是 .NET Framework 2.0 中的新属性。
Location (继承自 ConfigurationSection。)一个键属性。
MaxBatchGeneratedFileSize 一个读/写 sint32 值,该值指定每次批量编译生成的源文件的最大组合大小(以千字节为单位)。 默认值为 1000。 注意:此属性是 .NET Framework 2.0 中的新属性。
MaxBatchSize 一个读/写 sint32 值,该值指定编译到单个批次中的最大页数。 默认值为 1000。 注意:此属性是 .NET Framework 2.0 中的新属性。
NumRecompilesBeforeAppRestart 一个读/写 sint32 值,该值指定应用程序重启之前可能进行的资源动态重新编译次数。 默认值为 15。

此属性在全局和应用程序配置级别受支持,但在目录配置级别不受支持。 注意:此属性是 .NET Framework 2.0 中的新属性。
Path (继承自 ConfigurationSection。)一个键属性。
SectionInformation (从 ConfigurationSection 继承。)
Strict 一个读/写 boolean 值。 如果使用了 Visual Basic 严格编译选项,则为 true;否则,为 false。 默认为 false

true 时,编译显式禁止任何会发生数据丢失的数据类型转换,或数值类型与字符串之间的任何转换。 注意:此属性是 .NET Framework 2.0 中的新属性。
TempDirectory 一个读/写 string 值,该值指定编译期间用于临时文件存储的目录。 默认值为空字符串。

如果该字符串为空,且当前进程标识具有对 %FrameworkInstallLocation%\ Temporary ASP.NET Files 目录的必需权限,则使用该目录。 如果该字符串为空,且当前进程标识不具有对 Temporary ASP.NET Files 目录的必需权限,则系统会出现异常,或写入其具有权限的目录,例如用户配置文件中的 Temp 目录。 注意:此属性是 .NET Framework 2.0 中的新属性。
UrlLinePragmas 一个读/写 boolean 值。 如果编译器指令使用 URL,则为 true;如果编译器指令使用物理路径,则为 false。 默认为 false注意:此属性是 .NET Framework 2.0 中的新属性。

子类

此类不包含子类。

继承层次结构

ConfigurationSection

ConfigurationSectionWithCollection

CompilationSection

要求

类型 描述
客户端 - IIS 7.0(在 Windows Vista 上)
- IIS 7.5(在 Windows 7 上)
- IIS 8.0(在 Windows 8 上)
- IIS 10.0(在 Windows 10 上)
服务器 - IIS 7.0(在 Windows Server 2008 上)
- IIS 7.5(在 Windows Server 2008 R2 上)
- IIS 8.0(在 Windows Server 2012 上)
- IIS 8.5(在 Windows Server 2012 R2 上)
- IIS 10.0(在 Windows Server 2016 上)
产品 - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件 WebAdministration.mof

另请参阅

System.Web.Compilation.BuildProviderSystem.Web.Configuration.CompilationSectionAssemblySettings 类
BuildProviderSettings 类
ConfigurationSectionWithCollection 类
DirectorySettings 类
ExpressionBuilderSettings 类
<system.codedom> 元素