C# 編譯器選項

  • 發行項

本節說明 c # 編譯器所解釋的選項。 選項會根據其控制項的專案分組為不同的文章，例如，語言功能、程式碼產生和輸出。 使用目錄在這些目錄之間流覽。

如何設定選項

有兩種不同的方式可在 .NET 專案中設定編譯器選項：

  • 在您的 * .csproj 檔案中

    您可以用 XML 格式，加入* .csproj檔案中任何編譯器選項的 MSBuild 屬性。 屬性名稱與編譯器選項相同。 屬性的值會設定編譯器選項的值。 例如，下列專案檔程式碼片段會設定 LangVersion 屬性。

    <PropertyGroup>
  <LangVersion>preview</LangVersion>
</PropertyGroup>

    如需有關在專案檔中設定選項的詳細資訊，請參閱MSBuild .net SDK 專案的屬性檔。

  • 使用 Visual Studio 屬性頁

    Visual Studio 提供可編輯組建屬性的屬性頁。 若要深入瞭解，請參閱管理專案和方案屬性-Windows或管理專案和方案屬性-Mac。

.NET Framework 專案

重要

本節僅適用于 .NET Framework 專案。

除了上述的機制之外，您還可以針對 .NET Framework 專案，使用兩個額外的方法來設定編譯器選項：

  • .NET Framework 專案的命令列引數： .NET Framework 專案使用csc.exe而不是 建立專案。 您可以為 .NET Framework 專案指定csc.exe的命令列引數。
  • 編譯的 ASP.NET 網頁： .NET Framework 專案使用web.config檔的區段來編譯頁面。 針對新的組建系統和 ASP.NET Core 專案，會從專案檔中取得選項。

某些編譯器選項的單字已從csc.exe和 .NET Framework 專案變更為新的 MSBuild 系統。 這一節中會使用新的語法。 這兩個版本都會列在每個頁面的頂端。 針對 csc.exe，任何引數都會列在選項和冒號之後。 例如，此 -doc 選項會是：

-doc:DocFile.xml

您可以在命令提示字元中輸入 C# 編譯器的可執行檔名稱 (csc.exe)，藉此叫用該編譯器。

針對 .NET Framework 專案，您也可以從命令列執行csc.exe 。 每個編譯器選項都能以兩種形式使用︰-option 和 /option。 在 .NET Framework Web 專案中，您可以指定在web.config檔中編譯器代碼後端的選項。 如需詳細資訊，請參閱 編譯器 > 元素。

如果您使用 [Visual Studio 的開發人員命令提示字元] 視窗，所有必要的環境變數都會自動完成設定。 如需有關如何存取此工具的詳細資訊，請參閱Visual Studio 的開發人員命令提示字元。

csc.exe可執行檔通常位於Windows目錄下的 NET\Framework\ 版本 資料夾中。 它的位置可能依據特定電腦的實際組態而有所不同。 如果您的電腦上安裝了多個版本的 .NET Framework，您會發現此檔案有多個版本。 如需這類安裝的詳細資訊，請參閱如何：判斷安裝的 .NET Framework 版本。