AspNetCompiler 任务

更新:2007 年 11 月

AspNetCompiler 任务包装 aspnet_compiler.exe,这是一个预编译 ASP.NET 应用程序的实用工具。

任务参数

下表描述了 AspNetCompiler 任务的参数。

参数

说明

Clean

可选的 Boolean 参数

如果此参数为 true,将以全新方式生成预编译应用程序。以前编译过的任何组件都将重新进行编译。默认值为 false。此参数对应于 aspnet_compiler.exe 上的 -c 开关。

Debug

可选的 Boolean 参数

如果此参数为 true,将在编译期间发出调试信息(.PDB 文件)。默认值为 false。此参数对应于 aspnet_compiler.exe 上的 -d 开关。

Force

可选的 Boolean 参数

如果此参数为 true,则当目标目录已经存在时,此任务将改写该目录。现有的内容将丢失。默认值为 false。此参数对应于 aspnet_compiler.exe 上的 -f 开关。

MetabasePath

可选的 String 参数。

指定应用程序的完整 IIS 元数据库路径。此参数不能与 VirtualPathPhysicalPath 参数结合使用。此参数对应于 aspnet_compiler.exe 上的 -m 开关。

PhysicalPath

可选的 String 参数。

指定要编译的应用程序的物理路径。如果缺少此参数,将使用 IIS 元数据库来定位该应用程序。此参数对应于 aspnet_compiler.exe 上的 -p 开关。

TargetPath

可选的 String 参数。

指定应用程序将编译到的物理路径。如果未指定,将就地预编译该应用程序。

Timeout

可选的 Int32 参数。

指定在多少毫秒后终止任务可执行文件。默认值为 Int.MaxValue,这表示没有超时期限。

ToolPath

可选的 String 参数。

指定任务将从什么位置加载基础可执行文件 (aspnet_compiler.exe)。如果未指定此参数,任务将使用与运行 MSBuild 的 Framework 版本对应的 SDK 安装路径。

Updateable

可选的 Boolean 参数。

如果此参数为 true,则预编译的应用程序将是可更新的。默认值为 false。此参数对应于 aspnet_compiler.exe 上的 -u 开关。

VirtualPath

可选的 String 参数。

要编译的应用程序的虚拟路径。如果指定了 PhysicalPath,将使用物理路径来定位该应用程序。否则,将使用 IIS 元数据库,并假定应用程序位于默认站点中。此参数对应于 aspnet_compiler.exe 上的 -v 开关。

示例

下面的代码示例使用 AspNetCompiler 任务来预编译 ASP.NET 应用程序。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="PrecompileWeb">
        <AspNetCompiler
            VirtualPath="/MyWebSite"
            PhysicalPath="c:\inetpub\wwwroot\MyWebSite\"
            TargetPath="c:\precompiledweb\MyWebSite\"
            Force="true"
            Debug="true"
        />
    </Target>
</Project>

请参见

概念

MSBuild 任务

其他资源

MSBuild 任务参考