通用的 MSBuild 專案項目

發行項
03/01/2024

在 MSBuild 中，項目是一個或多個檔案的具名參考。項目包含中繼資料，例如檔案名稱、路徑和版本號碼。 Visual Studio 中的所有專案類型都有數個通用項目。這些項目會在 Microsoft.Build.CommonTypes.xsd 檔案中定義。

本文列出所有常見的專案項目。

參考

代表專案中的組件 (受管理) 參考。

項目中繼資料名稱	描述
提示路徑	選擇性字串。組件的相對或絕對路徑。
名稱	選擇性字串。組件的顯示名稱，例如，"System.Windows.Forms"。
融合名稱	選擇性字串。指定項目的簡單或強式融合名稱。當此屬性存在時，可能會節省時間，因為元件檔案不需要開啟即可取得融合名稱。
特定版本	選擇性布林值。指定是否應僅參考融合名稱中的版本。
別名	選擇性字串。參考的任何別名。
私人	選擇性布林值。指定是否應將參考複製到輸出資料夾。此屬性與 Visual Studio IDE 中參考的 [複製到本機] 屬性相符。

COM 參考

代表專案中的 COM (未受管理) 元件參考。此項目僅適用於 .NET 專案。

項目中繼資料名稱	描述
Name	選擇性字串。元件的顯示名稱。
Guid	必要的字串。元件的 GUID，格式為 {12345678-1234-1234-1234-123456781234}。
VersionMajor	必要的字串。元件的版本號碼主要部分。例如，如果完整版本號碼為"5.46"，則主要部分為 "5"。
VersionMinor	必要的字串。元件版本號碼的次要部分。例如，如果完整版本號碼為"5.46"，則次要部分為 "46"。
EmbedInteropTypes	選擇性布林值。若為 true，就會將 Interop 類型從這個參考直接內嵌到您的組件中，而不是產生 Interop DLL。
Lcid	選擇性字串。元件的地區設定識別碼。
包裝函式工具	選擇性字串。用於元件的包裝函式工具名稱。值為： 1. 主要 2. tlbimp 3. primaryortlbimp 4. `aximp`
隔離式方案	選擇性布林值。指定元件是否為免註冊元件。

COM 檔案參考

代表傳遞給 ResolveComReference 目標之 TypeLibFiles 參數的類型程式庫清單。此項目僅適用於 .NET 專案。

項目中繼資料名稱	描述
包裝函式工具	選擇性字串。用於元件的包裝函式工具名稱。值為： 1. 主要 2. tlbimp 3. primaryortlbimp 4. `aximp`

原生參考

代表原生的資訊清單檔案或是這類檔案的參考。

項目中繼資料名稱	描述
Name	必要的字串。資訊清單檔案的基底名稱。
提示路徑	必要的字串。資訊清單檔案的相對路徑。

專案參考

代表另一個專案的參考。 ProjectReference 項目會由 ResolveProjectReferences 目標轉換成參考項目，因此如果轉換程式未覆寫參考程式，則參考上的任何有效中繼資料在 ProjectReference 上都可能有效。

項目中繼資料名稱	描述
Name	選擇性字串。參考的顯示名稱。
GlobalPropertiesToRemove	選擇性 `string[]`。建置參考專案時要移除的屬性名稱，例如 `RuntimeIdentifier;PackOnBuild`。預設值為空白。
計畫	選擇性字串。參考的 GUID，格式為 {12345678-1234-1234-1234-123456781234}。
OutputItemType	選擇性字串。要發出目標輸出的項目類型。預設值為空白。如果 Reference 元數據設定為「true」（預設值），則目標輸出會變成編譯程序的參考。
ReferenceOutputAssembly	選擇性布林值。如果設定為 `false`，則不包含參考專案的輸出做為此項目的參考，但仍會確保其他專案會在此專案之前建置。預設為 `true`。
私人	選擇性布林值。指定是否應將參考複製到輸出資料夾。此屬性與 Visual Studio IDE 中參考的 [複製到本機] 屬性相符。
SetConfiguration	選擇性字串。設定參考專案的全域屬性 `Configuration`，例如 `Configuration=Release`。
SetPlatform	選擇性字串。設定參考專案的全域屬性 `Platform`，例如 `Platform=AnyCPU`。
SetTargetFramework	選擇性字串。設定參考專案的全域屬性 `TargetFramework`，例如 `TargetFramework=netstandard2.0`。
SkipGetTargetFrameworkProperties	選擇性布林值。如果 `true`，則會建置參考的專案，而不交涉最相容的 `TargetFramework` 值。預設為 `false`。
目標	選擇性 `string[]`。應建置之參考專案中的目標分號分隔清單。預設值為的值 `$(ProjectReferenceBuildTargets)`，預設值為空白，表示預設目標。

注意

.NET Framework 與 .NET Core 之間的專案參考運作方式有差異 (包括 .NET 5 和更新版本)。在 .NET Framework 專案中，項目參考不會轉移。也就是說，如果 Project1 參考 Project2，而 Project2 參考 Project3，則您無法從 Project1 針對 Project3 撰寫程式碼。不過，在 .NET Core (包括 .NET 5 和更新版本) 中，專案參考可轉移。您可以在 Project1 中針對 Project3 撰寫程式碼。

編譯

代表編譯器的原始程式檔。

項目中繼資料名稱	描述
相依依據	選擇性字串。指定這個檔案必須倚賴才能正確編譯的檔案。
自動產生	選擇性布林值。指出是否已透過 Visual Studio 整合式開發環境 (IDE) 為專案產生檔案。
連結	選擇性字串。當檔案實際位於專案檔影響力之外時所顯示的標記路徑。
可見	選擇性布林值。指出是否要在 Visual Studio 的方案總管中顯示檔案。
複製到輸出目錄	選擇性字串。決定是否要將檔案複製到輸出目錄。值為： 1.永不 2.永遠 3.保留最新的

內嵌資源

代表要內嵌於所產生組件中的資源。

項目中繼資料名稱	描述
相依依據	選擇性字串。指定這個檔案必須倚賴才能正確編譯的檔案
Generator	選擇性字串。在此項目上執行的任何檔案產生器名稱。
最後產生輸出	選擇性字串。在此項目執行的任何檔案產生器所建立的檔案名稱。
自訂工具命名空間	選擇性字串。在此項目上執行的任何檔案產生器應在其中建立程式碼的命名空間。
連結	選擇性字串。如果檔案實際位於專案影響力之外，便會顯示標記路徑。
可見	選擇性布林值。指出是否要在 Visual Studio 的方案總管中顯示檔案。
複製到輸出目錄	選擇性字串。決定是否要將檔案複製到輸出目錄。值為： 1.永不 2.永遠 3.保留最新的
LogicalName	必要的字串。內嵌資源的邏輯名稱。

Content

表示未編譯至項目的檔案，但可能會內嵌或一起發行。

項目中繼資料名稱	描述
相依依據	選擇性字串。指定這個檔案必須倚賴才能正確編譯的檔案。
Generator	選擇性字串。在此項目上執行的任何檔案產生器名稱。
最後產生輸出	選擇性字串。在此項目執行的任何檔案產生器所建立的檔案名稱。
自訂工具命名空間	選擇性字串。在此項目上執行的任何檔案產生器應在其中建立程式碼的命名空間。
連結	選擇性字串。如果檔案實際位於專案影響力之外，便會顯示標記路徑。
發行狀態	必要的字串。內容的發行狀態，可以是： - 預設值 - 包含 - xcluded - 資料檔 - 必要條件
為組件	選擇性布林值。指定檔案是否為組件。
可見	選擇性布林值。指出是否要在 Visual Studio 的方案總管中顯示檔案。
複製到輸出目錄	選擇性字串。決定是否要將檔案複製到輸出目錄。值為： 1.永不 2.永遠 3.保留最新的
TargetPath	選擇性字串。項目的輸出路徑 (相對於組態和/或平台特定輸出目錄)，包括檔案名稱。如果提供，則會遵守 `Link` 中繼資料。如果未提供 TargetPath，則會在建置程式期間加以計算。請參閱 AssignTargetPath。

無

代表在建置流程中應該沒有任何角色的檔案。

項目中繼資料名稱	描述
相依依據	選擇性字串。指定這個檔案必須倚賴才能正確編譯的檔案。
Generator	選擇性字串。在此項目上執行的任何檔案產生器名稱。
最後產生輸出	選擇性字串。在此項目執行的任何檔案產生器所建立的檔案名稱。
自訂工具命名空間	選擇性字串。在此項目上執行的任何檔案產生器應在其中建立程式碼的命名空間。
連結	選擇性字串。如果檔案實際位於專案影響力之外，便會顯示標記路徑。
可見	選擇性布林值。指出是否要在 Visual Studio 的方案總管中顯示檔案。
複製到輸出目錄	選擇性字串。決定是否要將檔案複製到輸出目錄。值為： 1.永不 2.永遠 3.保留最新的

AssemblyMetadata

表示要產生為 [AssemblyMetadata(key, value)] 的組件屬性。

項目中繼資料名稱	描述
包括	成為 `AssemblyMetadataAttribute` 屬性建構函式中的第一個參數 (索引鍵)。
值	必要的字串。成為 `AssemblyMetadataAttribute` 屬性建構函式中的第二個參數 (值)。

注意

此項目適用於使用 SDK for .NET 5 (和 .NET Core) 和更新版本的專案。

InternalsVisibleTo

指定要發出為 [InternalsVisibleTo(..)] 組件屬性的組件。

項目中繼資料名稱	描述
包括	組件名稱。
機碼	選擇性字串。組件的公開金鑰。

注意

此項目適用於使用 SDK for .NET 5 (和 .NET Core) 和更新版本的專案。

基本應用程式資訊清單

代表組建的基本應用程式資訊清單，並包含 ClickOnce 部署安全性資訊。

程式碼分析匯入

代表要匯入的 FxCop 專案。

Import

代表應該由 Visual Basic 編譯器匯入命名空間的組件。

Folder

只有 Visual Studio 會使用這個專案做為空白資料夾的佔位元。填入資料夾時，它會由另一個元素取代。