C# コンパイラ オプション

このセクションでは、C# コンパイラによって解釈されるオプションについて説明します。 オプションは、言語機能、コード生成、出力など、そのコントロールに基づいて個別の記事にグループ化されます。 目次を使用して、それらの間を移動します。

オプションを設定する方法

.NET プロジェクトでコンパイラ オプションを設定するには、次の 2 つの方法があります。

• *.csproj ファイル内

  *.csproj ファイル内の任意のコンパイラ オプションの MSBuild プロパティを XML 形式で追加できます。 プロパティ名はコンパイラ オプションと同じです。 プロパティの値は、コンパイラ オプションの値を設定します。 たとえば、次のプロジェクト ファイル スニペットは、 LangVersion プロパティを設定します。

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

  プロジェクト ファイルのオプションの設定の詳細については、 .NET SDK プロジェクトの MSBuild プロパティに関する記事を参照してください。

• Visual Studio プロパティ ページの使用

  Visual Studio には、ビルド プロパティを編集するためのプロパティ ページが用意されています。 詳細については、「 プロジェクトとソリューションのプロパティの管理 」 ( Windows または プロジェクトとソリューションのプロパティの管理 ) を参照してください。

.NET Framework プロジェクト

上記のメカニズムに加えて、.NET Framework プロジェクト用の 2 つの追加メソッドを使用してコンパイラ オプションを設定できます。

• .NET Framework プロジェクトのコマンド ライン引数: .NET Framework プロジェクトでは、dotnet buildではなく csc.exe を使用してプロジェクトをビルドします。 .NET Framework プロジェクトに csc.exe するコマンド ライン引数を指定できます。
• コンパイル済み ASP.NET ページ: .NET Framework プロジェクトでは、ページのコンパイルに web.config ファイルのセクションが使用されます。 新しいビルド システムとコア プロジェクト ASP.NET 場合、オプションはプロジェクト ファイルから取得されます。

一部のコンパイラ オプションの単語は 、csc.exe および .NET Framework プロジェクトから新しい MSBuild システムに変更されました。 このセクションでは、新しい構文を使用します。 両方のバージョンが各ページの上部に表示されます。 csc.exeの場合、オプションとコロンの後に引数が一覧表示されます。 たとえば、 -doc オプションは次のようになります。

-doc:DocFile.xml

C# コンパイラを呼び出すには、コマンド プロンプトで実行可能ファイル (csc.exe) の名前を入力します。

.NET Framework プロジェクトの場合は、コマンド ラインから csc.exe を実行することもできます。 すべてのコンパイラ オプションは、 -option と /option の 2 つの形式で使用できます。 .NET Framework Web プロジェクトでは、 web.config ファイルで分離コードをコンパイルするためのオプションを指定します。 詳細については、「 <compiler> 要素」を参照してください。

Visual Studio の開発者コマンド プロンプト ウィンドウを使用する場合は、必要なすべての環境変数が設定されます。 このツールにアクセスする方法については、「 Visual Studio の開発者コマンド プロンプト」を参照してください。

csc.exe 実行可能ファイルは、通常、Windows ディレクトリの下の Microsoft.NET\Framework\<Version> フォルダーにあります。 その場所は、特定のコンピューターの正確な構成によって異なる場合があります。 コンピューターに複数のバージョンの .NET Framework がインストールされている場合は、このファイルの複数のバージョンがあります。 このようなインストールの詳細については、「 方法: インストールされている .NET Framework のバージョンを決定する」を参照してください。