AspNetCompiler タスク

  • [アーティクル]

AspNetCompiler タスクは、ASP.NET アプリケーションをプリコンパイルするためのユーティリティである aspnet_compiler.exe をラップします。

タスク パラメーター

AspNetCompiler タスクのパラメーターの説明を次の表に示します。

パラメーター 説明
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 型のパラメーターです。

使う必要がある aspnet_compiler.exe の .NET Framework バージョンを示す TargetFrameworkMoniker を指定します。 .NET Framework モニカーのみを受け付けます。
TargetPath 省略可能な String 型のパラメーターです。

アプリケーションのコンパイル先の物理パスを指定します。 指定しないと、アプリケーションはインプレースでプリコンパイルされます。
Updateable 省略可能な Boolean 型のパラメーターです。

このパラメーターが true の場合、プリコンパイルされたアプリケーションは更新可能です。 既定値は false です。 このパラメーターは、aspnet_compiler.exe の -u スイッチに対応します。
VirtualPath 省略可能な String 型のパラメーターです。

コンパイル対象のアプリケーションの仮想パス。 PhysicalPath を指定すると、アプリケーションの場所の指定に物理パスが使われます。 それ以外の場合は IIS メタベースが使われ、アプリケーションは既定のサイトにあるものと想定されます。 このパラメーターは、aspnet_compiler.exe の -v スイッチに対応します。

ToolTaskExtension パラメーター

このタスクが ToolTaskExtension クラスを継承します。このクラスは ToolTask クラスから継承され、さらに、このクラス自体は Task から継承されます。 この継承チェーンにより、これらのクラスから派生したタスクにいくつかのパラメーターが追加されます。

基本クラスのパラメーターの説明を次の表に示します。

パラメーター 説明
EchoOff 省略可能な bool 型のパラメーターです。

true に設定すると、このタスクは /Q を cmd.exe コマンド ラインに渡して、コマンド ラインが stdout にコピーされないようにします。
EnvironmentVariables 省略可能な String 型の配列パラメーターです。

セミコロンで区切られた環境変数定義の配列。 各定義では、環境変数の名前と値を等号で区切って指定する必要があります。 これらの変数は、標準の環境ブロックに加え (または標準の環境ブロックを選択的にオーバーライドして)、子の実行可能ファイルに渡されます。 たとえば、「 Variable1=Value1;Variable2=Value2 」のように入力します。
ExitCode 省略可能な Int32 型の読み取り専用出力パラメーターです。

実行したコマンドの終了コードを示します。 タスクがエラーを記録した一方で、プロセスの終了コードが 0 (成功) だった場合、これは -1 に設定されます。
LogStandardErrorAsError 省略可能な bool 型のパラメーターです。

true の場合、標準エラー ストリームで受け取ったすべてのメッセージがエラーとして記録されます。
StandardErrorImportance 省略可能な String 型のパラメーターです。

標準エラー ストリームのテキストを記録するときに使用する重要度です。
StandardOutputImportance 省略可能な String 型のパラメーターです。

標準出力ストリームのテキストを記録するときに使用する重要度です。
Timeout 省略可能な Int32 型のパラメーターです。

タスク実行を終了するまでの時間をミリ秒単位で指定します。 既定値は Int.MaxValue であり、タイムアウト期限がないことを示します。 タイムアウトはミリ秒単位です。
ToolExe 省略可能な string 型のパラメーターです。

プロジェクトで実装すると、ToolName をオーバーライドできます。 タスクでオーバーライドすると、ToolName を保持できます。
ToolPath 省略可能な string 型のパラメーターです。

タスクで基になる実行可能ファイルを読み込む場所を指定します。 このパラメーターを指定しない場合、タスクでは、MSBuild を実行しているフレームワークのバージョンに対応する SDK インストール パスが使用されます。
UseCommandProcessor 省略可能な bool 型のパラメーターです。

true に設定した場合、このタスクで直接コマンドを実行する代わりに、コマンド ラインのバッチ ファイルを作成し、そのファイルをコマンド プロセッサで実行します。
YieldDuringToolExecution 省略可能な bool 型のパラメーターです。

true に設定した場合、このタスクは、その実行時にノードを生成します。

例

次のコード例では、AspNetCompiler タスクを使って ASP.NET アプリケーションをプリコンパイルします。

<Project xmlns="http://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>

関連項目