MSBuild 工作參考

提供程式碼的工作，這些程式碼會在建置程序中執行。 下列清單中的工作會隨附在 MSBuild 中。 當安裝 Visual C++ 時，可使用其他工作來建置 Visual C++ 專案。 如需詳細資訊，請參閱Visual C++ 特有的 MSBuild 工作。

除了本節主題中所列出的參數，每項工作也都能具有下列參數：

參數	描述
Condition	選擇性 String 參數。 MSBuild 引擎用來決定是否要執行此工作的 Boolean 運算式。 如需 MSBuild 支援之條件的詳細資訊，請參閱 MSBuild 條件。
ContinueOnError	選擇性參數。 可以包含下列其中一個值: WarnAndContinue 或 true。 當工作失敗時，在 目標 項目和組建的後續工作繼續執行，因此，從工作的所有警告視為錯誤。 ErrorAndContinue。 當工作失敗時，在 Target 項目和組建的後續工作繼續執行，因此，從工作的任何錯誤都會被視為錯誤。 ErrorAndStop 或 錯誤 (預設值)。 當工作失敗時，在 Target 項目和組建的剩餘工作沒有執行，因此，整個項目 Target 和組建視為失敗。 .NET Framework 的版本。4.5 之前只支援 true 和 false 值。 如需詳細資訊，請參閱如何：忽略工作中的錯誤。

在本節中

• 工作基底類別
  將幾個衍生自 Task 類別的參數加入工作中。

• TaskExtension 基底類別
  將幾個衍生自 TaskExtension 類別的參數加入工作中。

• ToolTaskExtension 基底類別
  將幾個衍生自 ToolTaskExtension 類別的參數加入工作中。

• AL (組件連結器) 工作
  利用一個或多個模組檔案或資源檔建立包含資訊清單的組件。

• AspNetCompiler 工作
  包裝 aspnet_compiler.exe，這是先行編譯 ASP.NET 應用程式的公用程式。

• AssignCulture 工作
  指派文化特性 (Culture) 識別項給項目。

• AssignProjectConfiguration 工作
  接受組態字串清單，並將其指派給指定的專案。

• AssignTargetPath 工作
  接受檔案清單，並加入 <TargetPath> 屬性 (如果尚未指定的話)。

• CallTarget 工作
  叫用 (Invoke) 專案檔中的目標 (Target)。

• CombinePath 工作
  將指定的路徑結合成單一路徑。

• ConvertToAbsolutePath 工作
  將相對路徑或參考轉換成絕對路徑。

• Copy 工作
  將檔案複製至新的位置。

• CreateCSharpManifestResourceName 工作
  從指定的 .resx 檔案名稱或其他資源，建立 Visual C# 樣式的資訊清單名稱。

• CreateItem 工作
  以輸入項目填入項目集合，允許清單中的項目複製到另一份清單。

• CreateProperty 工作
  以傳入值填入屬性，允許值可以從一個屬性或字串複製到另一個屬性或字串。

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

• Csc 工作
  叫用 Visual C# 編譯器，以產生可執行檔、動態連結程式庫或程式碼模組。

• Delete 工作
  刪除指定的檔案。

• Error 工作
  停止建置並根據評估的條件陳述式記錄錯誤。

• Exec 工作
  以指定的引數執行指定的程式或命令。

• FindAppConfigFile 工作
  在提供的清單中尋找 app.config 檔案 (如果有的話)。

• FindInList 工作
  在指定的清單中，尋找擁有相符 itemspec 的項目。

• FindUnderPath 工作
  決定指定的項目集合中，那些項目存在於指定的資料夾及其所有的子資料夾中。

• FormatUrl 工作
  將 URL 轉換為正確的 URL 格式。

• FormatVersion 工作
  將修訂編號附加至版本號碼。

• GenerateApplicationManifest 工作
  產生 ClickOnce 應用程式資訊清單或原生 (Native) 資訊清單。

• GenerateBootstrapper 工作
  提供偵測、下載及安裝應用程式及其必要條件的自動化方法。

• GenerateDeploymentManifest 工作
  產生 ClickOnce 部署資訊清單。

• GenerateResource 工作
  將 .txt 和 .resx 檔轉換為 Common Language Runtime 二進位 .resources 檔。

• GenerateTrustInfo 工作
  從基底資訊清單，以及從 TargetZone 和 ExcludedPermissions 參數產生應用程式信任。

• GetAssemblyIdentity 工作
  從指定的檔案擷取組件 (Assembly) 識別 (Identity) 並輸出識別資訊。

• GetFrameworkPath 工作
  擷取 .NET Framework 組件的路徑。

• GetFrameworkSdkPath 工作
  擷取 Windows Software Development Kit (SDK) 的路徑。

• GetReferenceAssemblyPaths 工作
  傳回各種不同架構的參考組件路徑。

• LC 工作
  從 .licx 檔案產生 .license 檔案。

• MakeDir 工作
  建立目錄，並在必要時，建立任何父目錄。

• 訊息工作
  在建置期間記錄訊息。

• Move 工作
  將檔案移至新位置。

• MSBuild 工作
  從另一個 MSBuild 專案建置 MSBuild 專案。

• ReadLinesFromFile 工作
  從文字檔讀取項目清單。

• RegisterAssembly 工作
  讀取指定組件內的中繼資料，並將需要的項目加入登錄。

• RemoveDir 工作
  移除指定的目錄以及其中的所有檔案和子目錄。

• RemoveDuplicates 工作
  從指定的項目集合中移除重複的項目。

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

• ResGen 工作
  已過時。 使用 GenerateResource 工作 工作在 .txt 和 .resx 檔案，以及 Common Language Runtime 二進位 .resources 檔案之間轉換。

• ResolveAssemblyReference 工作
  決定相依於指定之組件 (Assembly) 的所有組件。

• ResolveComReference 工作
  取得一個或多個型別程式庫名稱或 .tlb 檔的清單，並將那些型別程式庫解析至磁碟上的位置。

• ResolveKeySource 工作
  決定強式名稱 (Strong Name) 金鑰來源

• ResolveManifestFiles 工作
  在建置程序中將下列項目解析成檔案以產生資訊清單：已建置的項目、相依性、附屬組件、內容、偵錯符號和文件。

• ResolveNativeReference 工作
  解析原生 (Native) 參考。

• ResolveNonMSBuildProjectOutput 工作
  決定非 MSBuild 專案參考的輸出檔。

• SGen 工作
  為指定組件中的型別建立 XML 序列化 (Serialization) 組件。

• SignFile 工作
  使用指定的憑證對指定的檔案簽章。

• Touch 工作
  設定檔案的存取和修改時間。

• UnregisterAssembly 工作
  移除註冊 COM interop 用途的指定組件。

• UpdateManifest 工作
  更新資訊清單中的選定屬性並重新簽署。

• Vbc 工作
  叫用 Visual Basic 編譯器，以產生可執行檔、動態連結程式庫或程式碼模組。

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

• WriteCodeFragment 工作
  使用指定的已產生程式碼片段來產生暫時程式碼檔。 請不要刪除這個檔案。

• WriteLinesToFile 工作
  將指定的項目寫入指定的文字檔。

• XmlPeek 工作
  從 XML 檔案傳回 XPath 查詢所指定的值。

• XmlPoke 工作
  設定值，如同 XML 檔案的 XPath 查詢所指定。

• XslTransformation 工作
  使用「可延伸樣式表語言轉換」(Extensible Stylesheet Language Transformation，XSLT) 或已編譯的 XSLT 來轉換 XML 輸入，並輸出至輸出裝置或檔案。

請參閱

概念

工作撰寫

MSBuild 工作

其他資源

MSBuild 參考