共用方式為

MSBuild 保留屬性

  • 發行項

MSBuild 提供了一組保留屬性，可用來儲存專案檔和 MSBuild 二進位碼檔案的相關資訊。 這些屬性會評估與其他 MSBuild 屬性相同。 例如，若要使用 MSBuildProjectFile 屬性，請輸入：

$(MSBuildProjectFile)

保留的屬性

下表說明 MSBuild 的保留屬性。

屬性

描述

MSBuildBinPath

例如目前使用尋找 MSBuild 二進位資料夾的絕對路徑 (例如， C:\Windows\Microsoft.Net\Framework\versionNumber\)。 如果您必須參考 MSBuild 目錄中的檔案，這個屬性是相當有用的。

MSBuildExtensionsPath

路徑 MSBuild 子資料夾在\ Program Files \或\ Program Files (x86) \資料夾，根據目前視窗的 Bitness。 例如，在 32 位元 Windows 在 64 位元電腦上，路徑指向\ Program Files (x86) \資料夾。 對於在 64 位元電腦上執行的 64 位元 Windows，對\ Program Files \資料夾的路徑)。 請參閱 MSBuildExtensionsPath32 和 MSBuildExtensionsPath64。

此位置可以用來放置自訂目標檔。 例如，您可以使用這個 XML 程式碼，您的目標檔案在專案檔中安裝在\ Program Files \ MSBuild \ MyFiles \ Northwind.targets 然後匯入:

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

注意事項注意事項
您可以設定環境變數 MSBUILDLEGACYEXTENSIONSPATH 到非 Null 值啟用 MSBuildExtensionsPath 行為在舊版的。

MSBuildExtensionsPath32

路徑 MSBuild 子資料夾在\ Program Files \或\ Program Files (x86) \資料夾。 這個路徑一律指向 32 位元\ Program Files \資料夾在 32 位元電腦和\ Program Files (x86) \在 64 位元電腦。 請參閱 MSBuildExtensionsPath 和 MSBuildExtensionsPath64。

MSBuildExtensionsPath64

MSBuild 子資料夾的路徑在\ Program Files \資料夾中。 針對 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 的 MSBuildDefaultTargets 屬性值為 A;B;C:

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

MSBuildProjectDirectory

尋找專案檔所在目錄的絕對路徑;例如， C:\MyCompany\MyProduct\。

MSBuildProjectDirectoryNoRoot

MSBuildProjectDirectory 屬性的值，不包含根磁碟機。

MSBuildProjectExtension

專案檔的副檔名，包括句號;例如， .proj。

MSBuildProjectFile

專案檔的完整檔名，包括副檔名;例如， MyApp.proj。

MSBuildProjectFullPath

專案檔的絕對路徑和完整檔名，包括副檔名;例如， C:\MyCompany\MyProduct\MyApp.proj。

MSBuildProjectName

專案檔的檔案名稱不含副檔名的檔案;例如， MyApp。

MSBuildStartupDirectory

呼叫 MSBuild 資料夾的絕對路徑。 使用這個屬性，您可以在特定檢視中建立所有在專案樹狀結構，而不需要建立 dirs.proj 檔案在每個目錄。 相反地，您的專案 (例如， c:\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

包含目標執行專案或目標檔案的絕對路徑。

提示提示
MSBuildThisFileFullPath 屬性會啟用相對路徑的規格是相對於目標檔案和不相對於原始專案檔的目標檔案。

MSBuildThisFileName

MSBuildThisFileFullPath的檔案名稱部分，但是沒有副檔名。

MSBuildToolsPath

與 MSBuildToolsVersion的值 MSBuild 版本的安裝路徑。

MSBuildToolsVersion

用來建立專案的 MSBuild 工具組版本。

注意事項注意事項
MSBuild 工具組包含工作、用來建立應用程式的目標和工具。工具包含編譯器 (例如 csc.exe 和 vbc.exe。如需詳細資訊，請參閱MSBuild Toolset (ToolsVersion) 和標準和自訂工具組的組態。

請參閱

概念

MSBuild 屬性

其他資源

MSBuild 參考