語言

MSBuild 工作參考

提供在建置流程期間執行之程式碼的工作。 下列清單的工作包含於 MSBuild 中。 若已安裝 C++ 工作負載,將提供可用來建置 C++ 專案的其他工作。 如需詳細資訊,請參閱 C++ 工作。

除了本節中主題所列的參數之外,每個工作也會有下列參數:

參數 描述
Condition 選擇性的 String 參數。

Boolean 運算式,MSBuild 引擎會使用此運算式來決定是否要執行此工作。 如需 MSBuild 所支援條件的相關資訊,請參閱條件。
ContinueOnError 選擇性的 參數。 可包含一或多個下列值:

- WarnAndContinue 或 true。 當工作失敗時,Target 項目中的後續工作與組建都會繼續執行,並將來自工作的所有錯誤視為警告。
- ErrorAndContinue。 當工作失敗時,Target 項目中的後續工作與組建都會繼續執行,並將來自工作的所有錯誤視為錯誤。
- ErrorAndStop 或 false (預設值)。 當工作失敗時,就不會執行 Target 項目中的其餘工作和組建,並將整個 Target 項目與組建視為失敗。

只有 4.5 版之前的 .NET Framework 版本支援 true 和 false 值。

如需詳細資訊,請參閱如何:忽略工作中的錯誤。

本節內容

將數個參數新增至從 Task 類別衍生的工作。 不適合直接使用。

將數個參數新增至從 TaskExtension 類別衍生的工作。 不適合直接使用。

將數個參數新增至從 ToolTaskExtension 類別衍生的工作。 不適合直接使用。

從一或多個模組或資源檔的檔案中,建立包含資訊清單的組件。

包裝 aspnet_compiler.exe,此為預先編譯 ASP.NET 應用程式的公用程式。

將文化特性識別項指派給項目。

接受組態字串清單,並將它們指派給指定的專案。

接受檔案清單,並加入 <TargetPath> 屬性 (如果尚未指定)。

叫用專案檔中的目標。

將指定的路徑結合成單一路徑。

將相對路徑或參考轉換為絕對路徑。

將檔案複製到新位置。

從指定的 .resx 檔案名稱或其他資源,建立 C# 樣式的資訊清單名稱。

從輸入項目填入項目集合,以允許將項目從某一個清單複製到另一個。

從輸入值填入屬性,以允許將值從某一個屬性或字串複製到另一個。

從指定的 .resx 檔案名稱或其他資源,建立 Visual Basic 樣式的資訊清單名稱。

叫用 Visual C# 編譯器來產生可執行檔、動態連結程式庫或程式碼模組。

刪除指定的檔案。

將檔案下載至指定的位置。

停止組建,並根據評估的條件陳述式來記錄錯誤。

使用指定的引數來執行指定的程式或命令。

在提供的清單中尋找 app.config 檔案 (若有的話)。

在指定的清單中尋找具有相符項目規格的項目。

判斷指定項目集合中的哪些項目存在於指定的資料夾及其所有子資料夾中。

將 URL 轉換為正確的 URL 格式。

將修訂編號附加至版本號碼。

產生 ClickOnce 應用程式資訊清單或原生資訊清單。

提供自動化方式來偵測、下載及安裝應用程式及其必要條件。

產生 ClickOnce 部署資訊清單。

將 .txt 和 .resx 檔案轉換為通用語言執行階段二進位 .resources 檔案。

從基底資訊清單,以及從 TargetZone 與 ExcludedPermissions 參數產生應用程式信任。

從指定的檔案擷取組件識別,並輸出識別資訊。

計算檔案或一組檔案內容的總和檢查碼。

擷取 .NET Framework 組件的路徑。

擷取 Windows 軟體開發套件 (SDK) 的路徑。

傳回各種架構的參考組件路徑。

從 .licx 檔案產生 .license 檔案。

建立目錄,以及任何父目錄 (如有必要)。

在建置期間記錄訊息。

將檔案移到新位置。

從另一個 MSBuild 專案建置 MSBuild 專案。

從文字檔讀取項目清單。

讀取指定組件內的中繼資料,並將必要的項目加入至登錄。

移除指定的目錄及其所有檔案和子目錄。

從指定的項目集合中移除重複項目。

判斷應用程式是否需要 .NET Framework 3.5 SP1。

  • ResGen 工作

已過時。 使用 GenerateResource 工作,將 .txt 和 .resx 檔案轉換為通用語言執行階段二進位 .resources 檔案,反之亦然。

判斷相依於指定組件的所有組件。

取得一或多個類型程式庫名稱或 .tlb 檔案的清單,並將那些類型程式庫解析至磁碟上的位置。

決定強式名稱金鑰來源

在建置流程中將下列項目解析為檔案,以產生資訊清單:建置的項目、相依性、附屬項目、內容、偵錯符號和文件。

解析原生參考。

決定非 MSBuild 專案參考的輸出檔。

針對指定組件中的型別建立 XML 序列化組件。

使用指定的憑證簽署指定的檔案。

設定檔案的存取和修改時間。

針對 COM Interop 用途將指定的組件取消註冊。

將 .zip 封存解壓縮至指定的位置。

更新資訊清單中選取的屬性,並重新簽署。

叫用 Visual Basic 編譯器來產生可執行檔、動態連結程式庫或程式碼模組。

驗證檔案是否符合預期的檔案雜湊。

在建置期間,根據評估的條件陳述式來記錄警告。

使用指定產生的程式碼片段來產生暫存程式碼檔。 不會刪除該檔案。

將指定的項目寫入指定的文字檔。

將 XPath 查詢所指定的值從 XML 檔案傳回。

將 XPath 查詢所指定的值設定至 XML 檔案。

使用「可延伸樣式表語言轉換」(XSLT) 或編譯的 XSLT 轉換 XML 輸入,並輸出到輸出裝置或檔案。

從目錄的內容建立 .zip 封存。

另請參閱