次の方法で共有

MSBuild 予約済みのプロパティ

  • [アーティクル]

MSBuild には、プロジェクト ファイルに関する情報と MSBuild のバイナリに関する情報を格納する一連の予約済みプロパティが用意されています。これらのプロパティは MSBuild の他のプロパティと同じように評価されます。たとえば、MSBuildProjectFile プロパティを使用するには、次のように入力します。

$(MSBuildProjectFile)

予約済みのプロパティ

次の表を使用して、MSBuild 予約済みプロパティを説明します。

プロパティ

説明

MSBuildBinPath

現在使用されている MSBuild の binary が存在するフォルダーの絶対パス (B: 15\Windows\Microsoft.Net\Framework\versionNumberの\)。このプロパティは、MSBuild ディレクトリのファイルを参照する必要がある場合に便利です。

MSBuildExtensionsPath

\Program Files\ または現在のウィンドウのビットによって\Program ファイル (x86) \フォルダーの下の MSBuild のサブフォルダーのパスです。たとえば、64 ビット コンピューター上の 32 ビット ウィンドウの場合、\Program へのパスには (x86) \フォルダーを格納します。64 ビット コンピューター上の 64 ビット ウィンドウの場合、\Program の Files\ のフォルダーへのパスのポインター。MSBuildExtensionsPath32 および MSBuildExtensionsPath64 も参照してください。

この場所は、カスタム ターゲット ファイルを格納するために役立ちます。たとえば、ターゲット ファイルを\Program Files\MSBuild\MyFiles\Northwind.targets にインストールし、プロジェクト ファイルに次の XML コードを使用してインポートできます:

<Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>

メモメモ
null 以外の値に以前のバージョンの MSBuildExtensionsPath の動作を有効にするために MSBUILDLEGACYEXTENSIONSPATH 環境変数を設定できます。

MSBuildExtensionsPath32

\Program Files\ または\Program の下の MSBuild のサブフォルダーのパス (x86) \フォルダーを格納します。32 ビット コンピューターと\Program の\Program の Files\ の 32 ビット フォルダーへのパスは常にこの点は (64 ビットの x86 コンピューターの\) をチェックします。MSBuildExtensionsPath および MSBuildExtensionsPath64 も参照してください。

MSBuildExtensionsPath64

\Program の Files\ フォルダーの下の MSBuild のサブフォルダーのパス。64 ビット コンピューターの場合、\Program の Files\ のフォルダーにこのパスは常にポイントします。32 ビット コンピューターの場合、このパスは空白です。MSBuildExtensionsPath および MSBuildExtensionsPath32 も参照してください。

MSBuildLastTaskResult

前のタスクにエラーがある場合 (警告されていても) 前のタスクが正常に完了した場合true、または false。

メモメモ
通常、エラーがタスクで発生した場合、エラーは、プロジェクト内で最後に実行されます。したがって、このプロパティの値は、これらのシナリオでは、を除く falseではありません:

MSBuildNodeCount

使用する同時にビルド プロセスの最大数。これは、コマンド ラインで /maxcpucount に指定した値です。値を指定せずに /maxcpucount を指定した場合は、MSBuildNodeCount は、コンピューター上のプロセッサの数を指定します。詳細については、「MSBuild コマンド ライン リファレンス」および「MSBuild での複数のプロジェクトの並行ビルド」を参照してください。

MSBuildProgramFiles32

32 ビットのプログラムのフォルダー位置; たとえば、C:\Program Files (x86)。

MSBuildProjectDefaultTargets

Project 要素の DefaultTargets 属性で指定されるターゲットの完全な一覧。たとえば、Project の次の要素に A;B;Cの MSBuildDefaultTargets のプロパティ値があります:

<Project DefaultTargets="A;B;C" >

MSBuildProjectDirectory

プロジェクト ファイルが置かれているディレクトリの絶対パス; たとえば、B: 15\MyCompany\MyProduct\。

MSBuildProjectDirectoryNoRoot

ドライブのルートを除く MSBuildProjectDirectory のプロパティの値。

MSBuildProjectExtension

ピリオドを含むプロジェクト ファイルのファイル名拡張子、; たとえば、.proj。

MSBuildProjectFile

ファイル名拡張子を含むプロジェクト ファイルの完全なファイル名、; たとえば、MyApp.proj。

MSBuildProjectFullPath

ファイル名拡張子を含むプロジェクト ファイルの絶対パスと完全なファイル名、; たとえば、B: 15\MyCompany\MyProduct\MyApp.proj.

MSBuildProjectName

ファイル名拡張子のないプロジェクト ファイルのファイル名; たとえば、MyApp。

MSBuildStartupDirectory

MSBuild が呼び出されるフォルダーの絶対パス。このプロパティを使用して、プロジェクト ツリーの特定の時点の下のディレクトリの dirs.proj ファイルを作成せずにすべてをビルドできます。代わりに、コード プロジェクト用に一つ、c 1 種類があります: 次に示す\traversal.proj 場合:

<Project ...>
    <ItemGroup>
        <ProjectFiles  
           Include="$
           (MSBuildStartupDirectory)
           **\*.csproj"/>
    </ItemGroup>
    <Target Name="build">
        <MSBuild    
        Projects="@(ProjectFiles)"/>
    </Target>
</Project>

ツリーで任意の時点でビルドするには、:入力します。

msbuild c:\traversal.proj

MSBuildThisFile

MSBuildThisFileFullPathのファイル名とファイル拡張子の部分。

MSBuildThisFileDirectory

MSBuildThisFileFullPathのディレクトリ部分。

MSBuildThisFileDirectoryNoRoot

ドライブのルート ディレクトリを除外 MSBuildThisFileFullPathの部分。

MSBuildThisFileExtension

MSBuildThisFileFullPathのファイル名拡張子の部分。

MSBuildThisFileFullPath

実行中のターゲットを含むプロジェクトまたは targets ファイルの絶対パス。

ヒントヒント
MSBuildThisFileFullPath のプロパティはターゲット ファイルではなく、元のプロジェクト ファイルの相対ターゲット ファイルの相対パスを有効にします。

MSBuildThisFileName

ファイル名拡張子のない MSBuildThisFileFullPathファイル名の部分。

MSBuildToolsPath

MSBuildToolsVersionの値に関連付けられている MSBuild のバージョンのインストール パス。

MSBuildToolsVersion

プロジェクトのビルドに使用する MSBuild のツールセットのバージョン。

メモメモ
MSBuild のツールセットは、タスク、ターゲット、およびツールからアプリケーションのビルドに使用される構成されます。ツールは、csc.exe や vbc.exe などのコンパイラが含まれます。詳細については、「MSBuild ツールセット (ToolsVersion)」および「標準ツールセット構成とカスタム ツールセット構成」を参照してください。

参照

概念

MSBuild プロパティ

その他の技術情報

MSBuild リファレンス