VCBuild 工作
更新：2007 年 11 月
包裝 vcbuild.exe，其會建置 Visual C++ 專案和包含 Visual C++ 專案的方案。如需詳細資訊，請參閱 VCBUILD 參考。
參數
下表說明 VCBuild 工作的參數。
參數 |
描述 |
|---|---|
AdditionalLibPaths |
選擇性 ITaskItem[] 參數。 在執行 vcbuild.exe 之前，指定其他路徑以附加至 LIBPATH 環境變數。 |
AdditionalOptions |
選擇性 String 參數。 指定其他不具有專屬工作參數 (Parameter) 的命令列參數 (Switch)。 |
Clean |
選擇性的 Boolean 參數。 如果為 true，則指定工作只會輸出清除建置輸出。如果 Rebuild 參數為 true，便會覆寫此參數。 |
Configuration |
選擇性的 String 參數。 指定組態的名稱和用來建置的平台。 例如：Debug|Win32。 這個參數只能用來指定組態名稱。 |
Override |
選擇性 ITaskItem 參數。 指定會覆寫專案檔設定的 VCBuild 屬性工作表檔的位置。 |
Platform |
選擇性 String 參數。 指定建置目標平台的名稱。 |
Projects |
需要 ITaskItem[] 參數。 指定要建置的專案。 |
Rebuild |
選擇性的 Boolean 參數。 如果為 true，則指定工作會在執行建置之前先清除建置輸出。這個參數會覆寫 Clean 參數。 |
SolutionFile |
選擇性 ITaskItem 參數。 建置方案時指定方案檔的完整路徑。這個參數是用來解析和方案有關的 Visual C++ 專案巨集。 |
Timeout |
選擇性的 Int32 參數。 指定以毫秒為單位的時間長度，這段時間過後即結束工作可執行檔。預設值為 Int.MaxValue，表示沒有逾時時間。 |
ToolPath |
選擇性的 String 參數。 指定工作將會載入基礎可執行檔 (vcbuild.exe) 的位置。如果未指定此參數，工作會使用對應於執行 MSBuild 之架構版本的 SDK 安裝路徑。 |
UseEnvironment |
選擇性 Boolean 參數。 true 以使用 INCLUDE 和 LIB 路徑的環境變數；否則，為 false。 |
AdditionalLinkLibraryPaths |
選擇性的 String 參數。 指定要附加到 LIB 環境變數的其他參考位置。Link.exe 會使用 LIB 路徑搜尋 Link 命令列上所指定的檔案，例如物件或程式庫。Lib.exe 不使用環境變數。 |
範例
下列範例使用 VCBuild 工作來建置由 vcprojects 項目集合指定的專案。
<VCBuild
Projects="@(vcprojects)"
Configuration="$(configuration)"
Rebuild="true"/>