次の方法で共有

dotnet 形式

この記事の対象: ✔️ .NET 6 SDK 以降のバージョン

Name

dotnet format -editorconfig 設定に一致するようにコードを書式設定します。

構文

dotnet format [<PROJECT | SOLUTION>]
  [--binarylog <BINARY-LOG-PATH>] [--diagnostics <DIAGNOSTICS>]
  [--exclude <EXCLUDE>] [--exclude-diagnostics <EXCLUDE-DIAGNOSTICS>]
  [--include <INCLUDE>] [--include-generated]
  [--no-restore] [--report <REPORT-PATH>] [--severity <LEVEL>]
  [-v|--verbosity <LEVEL>] [--verify-no-changes] [--version]

dotnet format -h|--help

説明

dotnet format は、スタイル設定と静的分析の推奨事項をプロジェクトまたはソリューションに適用するコード フォーマッタです。 設定は、editorconfig ファイルから読み取られます (存在する場合)。それ以外の場合は、既定の設定セットが使用されます。 詳細については、EditorConfig のドキュメントを参照してください。

引数

PROJECT | SOLUTION

コードの書式設定を実行する MSBuild プロジェクトまたはソリューション。 プロジェクトまたはソリューションのファイルを指定しない場合、MSBuild は、現在の作業ディレクトリから proj または sln のどちらかで終わるファイル拡張子を持つファイルを検索して、そのファイルを使います。

オプション

以下のオプションは、dotnet format コマンドを正常に実行するためには必要ありませんが、書式設定の内容および適用する規則をさらにカスタマイズするために使用できます。

  • --binarylog <BINARY-LOG-PATH>

    すべてのプロジェクトまたはソリューションの読み込み情報をバイナリ ログ ファイルに記録します。

  • --diagnostics <DIAGNOSTICS>

    コード スタイルまたはサードパーティの問題を修正するときにフィルターとして使用する診断 ID のスペース区切りのリスト。 既定値は、 .editorconfig ファイル内に列挙されている ID のいずれかです。 指定できる組み込みアナライザーの規則 ID の一覧については、コード分析のスタイル規則の ID の一覧を参照してください。

  • --exclude <EXCLUDE>

    書式設定から除外するファイルまたはフォルダーの相対パスのスペース区切りの一覧。 既定値は none です。

  • --exclude-diagnostics <EXCLUDE-DIAGNOSTICS>

    コード スタイルまたはサード パーティの問題を修正するときに除外する診断 ID のスペース区切りの一覧。 既定値は none です。 指定できる組み込みアナライザーの規則 ID の一覧については、コード分析のスタイル規則の ID の一覧を参照してください。

  • --include <INCLUDE>

    書式設定に含めるファイルまたはフォルダーの相対パスのスペース区切りの一覧。 既定値は、ソリューションまたはプロジェクト内のすべてのファイルです。

  • --include-generated

    SDK によって生成されたファイルを書式設定します。

  • --no-restore

    書式設定の前に暗黙的な復元は実行されません。 既定では、暗黙的な復元が行われます。

  • --report <REPORT-PATH>

    <REPORT_PATH> によって指定されたディレクトリに JSON レポートを生成します。

  • --severity <LEVEL>

    修正する診断の最小重要度。 使用できる値は、info、warn、および error です。 既定値は warn です。

  • --verify-no-changes

    書式設定の変更が実行されないことを確認します。 いずれかのファイルが書式設定されている場合は、ゼロ以外の終了コードで終了します。

  • --version

    バージョン情報を表示します。

  • -v|--verbosity <LEVEL>

    コマンドの詳細レベルを設定します。 指定できる値は、q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic] です。 詳細については、LoggerVerbosityを参照してください。

  • -?|-h|--help

    コマンドの使用方法を示した説明を出力します。

サブコマンド

空白

dotnet format whitespace - 空白の editorconfig 設定に一致するようにコードを書式設定します。

説明

dotnet format whitespace サブコマンドは、空白の書式設定に関連付けられている書式設定規則のみを実行します。 .editorconfig ファイルで指定できる書式設定オプションの完全な一覧については、「C# 書式設定オプション」をご覧ください。

オプション

  • --folder

    <PROJECT | SOLUTION> 引数を、コード ファイルのシンプルなフォルダーへのパスとして扱います。

Style

dotnet format style - コード スタイルの EditorConfig 設定に一致するようにコードを書式設定します。

説明

dotnet format style サブコマンドは、コード スタイルの書式設定に関連付けられている書式設定規則のみを実行します。 editorconfig ファイルで指定できる書式設定オプションの完全な一覧については、コード スタイルに関する規則を参照してください。

オプション

  • --diagnostics <DIAGNOSTICS>

    コード スタイルの問題を修正するときにフィルターとして使用する診断 ID のスペース区切りの一覧。 既定値は、 .editorconfig ファイル内に列挙されている ID のいずれかです。 指定できる組み込みのコード スタイル アナライザー ルール ID の一覧については、コード分析スタイルルールの ID の リストを参照してください。

  • --severity <LEVEL>

    修正する診断の最小重要度。 使用できる値は、info、warn、および error です。 既定値は warn

アナライザー

dotnet format analyzers - アナライザーの editorconfig 設定と一致するようにコードを書式設定します (コード スタイル ルールを除く)。

説明

dotnet format analyzers サブコマンドは、アナライザーに関連付けられている書式設定規則のみを実行します。 editorconfig ファイルで指定できるアナライザー ルールの一覧については、「Quality rules」を参照してください。

オプション

  • --diagnostics <DIAGNOSTICS>

    コード スタイル以外の問題を修正するときにフィルターとして使用する診断 ID のスペース区切りの一覧。 既定値は、 .editorconfig ファイル内に列挙されている ID のいずれかです。 指定できる組み込みのアナライザー ルール ID の一覧については、品質規則の ID の 一覧を参照してください。 サード パーティ製アナライザーについては、そのドキュメントを参照してください。

  • --severity <LEVEL>

    修正する診断の最小重要度。 使用できる値は、info、warn、および error です。 既定値は warn です。

例

  • ソリューションのすべてのコードを書式設定します。

    dotnet format ./solution.sln

  • アプリケーション プロジェクトのすべてのコードをクリーンアップします。

    dotnet format ./src/application.csproj

  • すべてのコードが正しく書式設定されていることを確認します。

    dotnet format --verify-no-changes

  • src と tests ディレクトリのすべてのコードのクリーンアップを行いますが、src/submodule-a では行いません。

    dotnet format --include ./src/ ./tests/ --exclude ./src/submodule-a/

  • 特定の コード スタイル 問題を修正します。

    dotnet format style --diagnostics IDE0005 --severity info

  • 重大度が、info、またはwarningがあるすべてのerror問題を修正します。

    dotnet format style --severity info

  • 特定の (コード スタイル以外の) アナライザーの問題を修正します。

    dotnet format analyzers --diagnostics CA1831 --severity warn

  • 重大度が info、 warning 、または errorを持つすべてのコード スタイルの問題を修正します。

    dotnet format analyzers --severity info
  • Last updated on