AspNetCompiler 任务
AspNetCompiler 任务包装 aspnet_compiler.exe,这是一个用于预编译 ASP.NET 应用程序的实用工具。
任务参数
下表描述了 AspNetCompiler 任务的参数。
Parameter |
说明 |
---|---|
AllowPartiallyTrustedCallers |
可选 Boolean 参数。 如果此参数为 true,则强名称程序集将允许部分受信任的调用方。 |
Clean |
可选 Boolean 参数 如果此参数为 true,将以全新方式生成预编译应用程序。 以前编译过的任何组件都将重新进行编译。 默认值为 false。 此参数对应于 aspnet_compiler.exe 上的 -c 开关。 |
Debug |
可选 Boolean 参数。 如果此参数为 true,将在编译期间发出调试信息(.PDB 文件)。 默认值为 false。 此参数对应于 aspnet_compiler.exe 上的 -d 开关。 |
DelaySign |
可选 Boolean 参数。 如果此参数为 true,则程序集在创建时未完全签名。 |
FixedNames |
可选 Boolean 参数。 如果此参数为 true,则编译的程序集将有固定名称。 |
Force |
可选 Boolean 参数 如果此参数为 true,则当目标目录已经存在时,此任务将覆盖该目录。 现有的内容将丢失。 默认值为 false。 此参数对应于 aspnet_compiler.exe 上的 -f 开关。 |
KeyContainer |
可选 String 参数。 指定强名称密钥容器。 |
KeyFile |
可选 String 参数。 指定强名称密钥文件的物理路径。 |
MetabasePath |
可选 String 参数。 指定应用程序的完整 IIS 元数据库路径。 此参数不能与 VirtualPath 或 PhysicalPath 参数结合使用。 此参数对应于 aspnet_compiler.exe 上的 -m 开关。 |
PhysicalPath |
可选 String 参数。 指定要编译的应用程序的物理路径。 如果缺少此参数,将使用 IIS 元数据库来定位该应用程序。 此参数对应于 aspnet_compiler.exe 上的 -p 开关。 |
TargetFrameworkMoniker |
可选 String 参数。 指定 TargetFrameworkMoniker,用于指示应使用哪个 .NET Framework 版本的 aspnet_compiler.exe。 只接受 .NET Framework 名字对象。 |
TargetPath |
可选 String 参数。 指定应用程序将编译到的物理路径。 如果未指定,将就地预编译该应用程序。 |
Updateable |
可选 Boolean 参数。 如果此参数为 true,则预编译的应用程序将是可更新的。 默认值为 false。 此参数对应于 aspnet_compiler.exe 上的 -u 开关。 |
VirtualPath |
可选 String 参数。 要编译的应用程序的虚拟路径。 如果指定了 PhysicalPath,将使用物理路径来定位该应用程序。 否则,将使用 IIS 元数据库,并假定应用程序位于默认站点中。 此参数对应于 aspnet_compiler.exe 的 -v 开关。 |
备注
除了上面列出的参数,此任务还将从 ToolTaskExtension 类继承参数,此类本身从 ToolTask 类继承。 有关这些附加参数及其说明的列表,请参见 ToolTaskExtension 基类。
示例
下面的代码示例使用 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>