AspNetCompiler タスク
更新 : 2007 年 11 月
AspNetCompiler タスクは、aspnet_compiler.exe をラップするものです。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 メタベースの完全パスを指定します。このパラメータを VirtualPath パラメータや PhysicalPath パラメータと一緒に使用することはできません。このパラメータは、aspnet_compiler.exe の -m スイッチに相当します。 |
PhysicalPath |
省略可能な String 型のパラメータです。 コンパイル対象のアプリケーションの物理パスを指定します。このパラメータを指定しなかった場合には、IIS メタベースを使用してアプリケーションの場所が判断されます。このパラメータは、aspnet_compiler.exe の -p スイッチに相当します。 |
TargetPath |
省略可能な String 型のパラメータです。 コンパイルしたアプリケーションを格納するパスを物理パスで指定します。指定しなかった場合、アプリケーションは、所定の場所にプリコンパイルされます。 |
Timeout |
省略可能な Int32 型のパラメータです。 実行可能なタスクを終了するまでの時間をミリ秒単位で指定します。既定値は Int.MaxValue であり、タイムアウト期限がないことを示します。 |
ToolPath |
省略可能な String 型のパラメータです。 タスクで基になる実行可能ファイル (aspnet_compiler.exe) を読み込む場所を指定します。このパラメータを指定しないと、MSBuild を実行しているフレームワークのバージョンに対応する 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>