共用方式為


C# 編譯程序選項

本節描述 C# 編譯程式所解譯的選項。 選項會根據其控制的內容,分組成個別的文章,例如語言功能、程式代碼產生和輸出。 使用目錄在它們之間巡覽。

如何設定選項

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

  • 在您的 *.csproj 檔案中

    您可以在 XML 格式的 *.csproj 檔案中,為任何編譯程式選項新增 MSBuild 屬性。 屬性名稱與編譯程式選項相同。 屬性值會設定編譯程式選項的值。 例如,下列項目檔代碼段會設定 LangVersion 屬性。

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

    如需在專案檔中設定選項的詳細資訊,請參閱 .NET SDK 專案的 MSBuild 屬性一文。

  • 使用 Visual Studio 屬性頁面

    Visual Studio 提供屬性頁來編輯組建屬性。 若要深入了解它們,請參閱 管理專案和方案屬性 - Windows管理專案和方案屬性 - Mac

.NET Framework 專案

這很重要

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

除了上述機制之外,您還可以使用 .NET Framework 專案的其他兩種方法來設定編譯程序選項:

  • .NET Framework 專案的命令行自變數:.NET Framework 專案會使用 csc.exe ,而不是 dotnet build 建置專案。 您可以指定命令行自變數來 csc.exe .NET Framework 專案。
  • 編譯 ASP.NET 頁:.NET Framework 專案會使用 web.config 檔案的 區段來編譯頁面。 針對新的建置系統,ASP.NET Core 專案,選項會取自項目檔。

某些編譯程式選項的字組已從 csc.exe 和 .NET Framework 項目變更為新的 MSBuild 系統。 本節中會使用新的語法。 這兩個版本都會列在每個頁面頂端。 針對 csc.exe,任何自變數都列在 選項和冒號之後。 例如, -doc 選項會是:

-doc:DocFile.xml

您可以在命令提示字元中輸入其可執行檔的名稱(csc.exe),以叫用 C# 編譯程式。

針對 .NET Framework 專案,您也可以從命令行執行 csc.exe 。 每個編譯程式選項都提供兩種形式: -option/option。 在 .NET Framework Web 專案中,您可以指定在 web.config 檔案中編譯程式代碼後置的選項。 欲了解更多資訊,請參閱 <compiler> 元素

如果您使用 Visual Studio 開發人員命令提示字元 視窗,則會為您設定所有必要的環境變數。 如需如何存取此工具的資訊,請參閱 Visual Studio的開發人員命令提示字元

csc.exe 可執行檔通常位於 < 目錄下的 Microsoft.NET\Framework\>Version 資料夾中。 其位置可能會根據特定計算機的確切組態而有所不同。 如果您的電腦上安裝了多個版本的 .NET Framework,您將找到此檔案的多個版本。 如需這類安裝的詳細資訊,請參閱 如何:判斷已安裝的 .NET Framework 版本