專案設計工具、建置頁 (C#)

  • 發行項

您可以使用 [專案設計工具] 的 [建置] 頁面，來指定專案的組建組態屬性。 此頁面只適用於 Visual C# 專案。

若要存取 [建置] 頁面，請在方案總管中選擇專案節點 (而不是 [方案] 節點)。 然後，依序選擇功能表列上的 [檢視] 和 [屬性頁]。 當 [專案設計工具] 出現時，請選擇 [建置] 索引標籤。

注意

在本文的某些 Visual Studio 使用者介面項目中，您的電腦可能會顯示不同的名稱或位置。 您可能使用不同的 Visual Studio 版本或不同的環境設定。 如需詳細資訊，請參閱將 IDE 個人化。

組態和平台

下列選項可讓您選取要顯示或修改的組態和平台。

注意

使用簡化的組建組態時，專案系統會決定要建置偵錯或發行版本。 因此不會顯示這些選項。 如需詳細資訊，請參閱如何：設定偵錯和發行組態。

Configuration

指定要顯示或修改的組態設定。 設定可以是 [使用中 (偵錯)] (這是預設值)、[偵錯]、[發行] 或 [所有組態]。

平台

指定要顯示或修改的平台設定。 預設設定為 [使用中 (任何 CPU)]。 您可以使用 [組態管理員] 來變更使用中的平台。 如需詳細資訊，請參閱如何：建立和編輯組態。

一般

下列選項可讓您設定幾個 C# 編譯器設定。

條件式編譯的符號

指定執行條件式編譯的符號。 請以分號 (";") 分隔符號。 如需詳細資訊，請參閱 /define (C# 編譯器選項)。

定義 DEBUG 常數

將 DEBUG 定義為應用程式中所有原始程式碼檔的符號。 選取此選項相當於使用 /define:DEBUG 命令列選項。

定義 TRACE 常數

將 TRACE 定義為應用程式中所有原始程式碼檔的符號。 選取此選項相當於使用 /define:TRACE 命令列選項。

平台目標

指定輸出檔設為目標的處理器。 針對任何 32 位元 Intel 相容處理器選擇 [x86]，針對任何 64 位元 Intel 相容處理器選擇 [x64]，針對 ARM 處理器選擇 [ARM]，或選擇 [任何 CPU] 指定可接受任何處理器。 [任何 CPU] 是專案的預設值，因為這可讓應用程式在種類範圍最廣的不同硬體上執行。

如需詳細資訊，請參閱 /platform (C# 編譯器選項)。

可為 Null

指定全專案 C# 可為 Null 的內容。 此 UI 選項是在 Visual Studio 16.5 中引進，而且只會針對使用 C# 8.0 或更新版本的專案啟用。

如需詳細資訊，請參閱可為 Null 的內容。

建議使用 32 位元

如果選取 [建議使用 32 位元] 核取方塊，應用程式將在 32 位元和 64 位元版本的 Windows 上當作 32 位元應用程式執行。 如果清除此核取方塊，應用程式將在 32 位元版本的 Windows 上當作 32 位元應用程式執行，並在 64 位元版本的 Windows 上當作 64 位元應用程式執行。

如果您將應用程式當作 64 位元應用程式執行，則指標大小會加倍，而且可能發生與其他完全為 32 位元之程式庫的相容性問題。 只有在需要超過 4 GB 的記憶體，或 64 位元指令提供明顯效能改善時，執行 64 位元應用程式才有用。

只有在下列所有條件都成立時，才能使用此核取方塊：

  • 在 [建置] 頁面上，[平台目標] 清單設定為 [任何 CPU]。

  • 在 [應用程式] 頁面上，[輸出類型] 清單指定專案是應用程式。

  • 在 [應用程式] 頁面上，[目標 Framework] 清單指定 .NET Framework 4.5。

容許 unsafe 程式碼

允許程式碼使用 unsafe 關鍵字來進行編譯。 如需詳細資訊，請參閱 /unsafe (C# 編譯器選項)。

最佳化程式碼

啟用或停用由編譯器執行的最佳化，讓您的輸出檔變得更小、更快且更有效率。 如需詳細資訊，請參閱 /optimize (C# 編譯器選項)。

錯誤和警告

您可以使用下列設定，為建置流程設定錯誤和警告選項。

警告層級

指定顯示編譯器警告的層級。 如需詳細資訊，請參閱 /warn (C# 編譯器選項)。

隱藏警告

封鎖編譯器產生一或多個警告的功能。 請以逗號或分號分隔多個警告編號。 如需詳細資訊，請參閱 /nowarn (C# 編譯器選項)。

警告視為錯誤

您可以使用下列設定，指定要將哪些警告視為錯誤。 請選取下列其中一個選項，以指出在何種情況下當建置出現警告時要傳回錯誤。 如需詳細資訊，請參閱 /warnaserror (C# 編譯器選項)。

無 - 不會將警告視為錯誤。

全部 - 將所有警告視為錯誤。

特定警告 - 將指定警告視為錯誤。 請以逗號或分號分隔多個警告編號。

提示

如果您不想將程式碼分析警告視為錯誤，請參閱程式碼分析常見問題。

輸出

您可以使用下列設定，為建置流程設定輸出選項。

輸出路徑

指定此專案組態的輸出檔案位置。 在此方塊中輸入建置輸出的路徑，或選擇 [瀏覽] 按鈕以指定路徑。 路徑是相對的；如果您輸入絕對路徑，它會儲存為相對路徑。 預設路徑為 bin\Debug or bin\Release\。

使用簡化的組建組態時，專案系統會決定要建置偵錯或發行版本。 不論您指定的 [輸出路徑] 為何，[偵錯] 功能表 (F5) 中的 [建置] 命令都會將組建放在偵錯位置。 不過，[建置] 功能表中的 [建置] 命令卻會將其放在您指定的位置。 如需詳細資訊，請參閱了解組建組態。

XML 文件檔案

指定將要在其中處理文件註解之檔案的名稱。 如需詳細資訊，請參閱 /doc (C# 編譯器選項)。

註冊 COM Interop

表示您的 Managed 應用程式將會公開 COM 物件 (COM 可呼叫包裝函式)，讓 COM 物件可與 Managed 應用程式互動。 您必須在 [專案設計工具] 的 [應用程式] 頁面中，將此應用程式的 [輸出類型] 屬性設定為 [類別庫]，才能使用 [註冊 COM Interop] 屬性。 如需您想要加入 Visual C# 應用程式並公開為 COM 物件的範例類別，請參閱範例 COM 類別。

產生序列化組件

指定編譯器是否會使用 XML 序列化程式產生器工具 (Sgen.exe) 來建立 XML 序列化組件。 如果您已在程式碼中使用該類別將類型序列化，則序列化組件可提升 XmlSerializer 的啟動效能。 此選項預設為 [自動]，指定只有您已在程式碼中使用 XmlSerializer 將類型編碼為 XML 時，才會產生序列化組件。 [關閉] 指定不論您的程式碼是否使用 XmlSerializer，永遠不會產生序列化組件。 On 指定永遠會產生序列化組件。 序列化組件將命名為 TypeName.XmlSerializers.dll。 如需詳細資訊，請參閱 XML 序列化程式產生器工具 (Sgen.exe)。

進階者

按一下可顯示 [進階建置設定] 對話方塊 (C#)。

另請參閱