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>

参照

概念

MSBuild タスク

その他の技術情報

MSBuild タスク リファレンス