一般 MSBuild 專案項目

更新：2007 年 11 月

在 MSBuild 中，項目是一個或多個檔案的具名參考。項目包含中繼資料 (Metadata)，例如檔案名稱、路徑和版本號碼。Visual Studio 中的所有專案類型有幾個通用的項目。這些項目定義在 microsoft.build.commontypes.xsd 檔案中。

通用項目

以下列出所有通用的專案項目：

Reference

代表專案中的組件 (Managed) 參考。

項目屬性名稱	描述
HintPath	選擇性字串。組件的相對或絕對路徑。
Name	選擇性字串。組件的顯示名稱，例如 "System.Windows.Forms"。
FusionName	選擇性字串。指定簡單或強式融合名稱做為項目的名稱。 如果有此屬性，就可以節省時間，因為不需要開啟組件檔，就能取得融合名稱。
SpecificVersion	選擇性布林值。指定是否只應參考融合名稱中的版本。
Aliases	選擇性字串。參考的任何別名。
Private	選擇性布林值。指定是否應將參考複製到輸出資料夾。

COMReference

代表專案中的 COM (Unmanaged) 元件參考。

項目屬性名稱	描述
Name	選擇性字串。元件的顯示名稱。
Guid	選擇性字串。元件的 GUID，格式為 {12345678-1234-1234-1234-1234567891234}。
VersionMajor	選擇性字串。元件版本號碼的主要部分。例如，如果完整版本號碼為 "5.46"，這就是 "5"。
VersionMinor	選擇性字串。元件版本號碼的次要部分。例如，如果完整版本號碼為 "5.46"，這就是 "46"。
LCID	選擇性字串。元件的地區設定 ID (LocaleID)。
WrapperTool	選擇性字串。在元件上使用的包裝函式工具名稱，例如 "tlbimp"。
Isolated	選擇性布林值。指定元件是否為免註冊元件。

COMFileReference

代表饋送到 ResolvedComreference 目標的型別程式庫清單。

項目屬性名稱	描述
WrapperTool	選擇性字串。在元件上使用的包裝函式工具名稱，例如 "tlbimp"。

NativeReference

代表原生資訊清單檔案或該檔案的參考。

項目屬性名稱	描述
Name	必要字串。資訊清單檔的主檔名 (Base Name)。
HintPath	必要字串。資訊清單檔的相對或絕對路徑。

ProjectReference

代表其他專案的參考。

項目屬性名稱	描述
Name	選擇性字串。參考的顯示名稱。
Project	選擇性字串。參考的 GUID，格式為 {12345678-1234-1234-1234-1234567891234}。
Package	選擇性字串。所參考專案檔的路徑。

Compile

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

項目屬性名稱	描述
DependentUpon	選擇性布林值。指出若要正確編譯，檔案是否相依於其他檔案。
AutoGen	選擇性布林值。指出專案的檔案是否由 Visual Studio 整合式開發環境 (IDE) 所產生。
Link	選擇性字串。當檔案實際位於專案檔影響範圍以外的位置時，要顯示的標記路徑。
Visible	選擇性布林值。指出是否在 Visual Studio 的 [方案總管] 中顯示此檔案。
CopyToOutputDirectory	選擇性布林值。預設值 = false。指定是否要將此檔案複製到輸出目錄中。

EmbeddedResource

代表將內嵌到所產生組件的資源。

項目屬性名稱	描述
DependentUpon	選擇性布林值。指出若要正確編譯，檔案是否相依於其他檔案。
Generator	必要字串。在此項目上執行的任何檔案產生器名稱。
LastGenOutput	必要字串。由在此項目上執行的任何檔案產生器所建立的檔案名稱。
CustomToolNamespace	必要字串。命名空間，其中所有在此項目上執行的檔案產生器都應該建立程式碼。
Link	選擇性字串。若檔案實際位於專案檔影響範圍以外的位置，所顯示的標記路徑。
Visible	選擇性布林值。指出是否在 Visual Studio 的 [方案總管] 中顯示此檔案。
CopyToOutputDirectory	選擇性布林值。預設值 = false。指定是否要將此檔案複製到輸出目錄中。
LogicalName	必要字串。內嵌資源的邏輯名稱。

內容

代表未編譯到專案，但可能會內嵌或一起發行的檔案。

項目屬性名稱	描述
DependentUpon	選擇性布林值。指出若要正確內嵌或發行，檔案是否相依於其他檔案。
Generator	必要字串。在此項目上執行的任何檔案產生器名稱。
LastGenOutput	必要字串。由在此項目上執行的任何檔案產生器所建立的檔案名稱。
CustomToolNamespace	必要字串。命名空間，其中所有在此項目上執行的檔案產生器都應該建立程式碼。
Link	選擇性布林值。指出是否在 Visual Studio 的 [方案總管] 中顯示此檔案。
PublishState	必要字串。內容的發行狀態，可能是： Default Included Excluded DataFile Prerequisite
IsAssembly	選擇性布林值。指定檔案是否為組件。
Visible	選擇性布林值。指出是否在 Visual Studio 的 [方案總管] 中顯示此檔案。
CopyToOutputDirectory	選擇性布林值。預設值 = false。指定是否要將此檔案複製到輸出目錄中。

None

代表在建置處理序中沒有角色的檔案。

項目屬性名稱	描述
DependentUpon	選擇性布林值。指出若要正確內嵌或發行，檔案是否相依於其他檔案。
Generator	必要字串。在此項目上執行的任何檔案產生器名稱。
LastGenOutput	必要字串。由在此項目上執行的任何檔案產生器所建立的檔案名稱。
CustomToolNamespace	必要字串。命名空間，其中所有在此項目上執行的檔案產生器都應該建立程式碼。
Link	選擇性字串。若檔案實際位於專案檔影響範圍以外的位置，要顯示的標記路徑。
Visible	選擇性布林值。指出是否在 Visual Studio 的 [方案總管] 中顯示此檔案。
CopyToOutputDirectory	選擇性布林值。預設值 = false。指定是否要將此檔案複製到輸出目錄中。

BaseApplicationManifest

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

CodeAnalysisImport

代表要匯入的 FxCop 專案。

匯入

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

請參閱

參考

一般 MSBuild 專案屬性