Visual Studio では、ビルド時とデザイン時にソース コード アナライザーを実行するかどうかを制御できます。 無効にできる制限事項があり、コード分析をオフにする手順は、いくつかの要因によって異なります。
プロジェクトの種類 (.NET Core、.NET Standard、.NET 5 以降と .NET Framework)
.NET Core、.NET Standard、および .NET 5 以降のプロジェクトには、 NuGet パッケージとしてインストールされているアナライザーからコード分析をオフにするためのオプションがあります。 詳細については、「 .NET Core、.NET Standard、.NET 5 以降のプロジェクト」を参照してください。 これに対し、.NET Framework プロジェクトでは、プロジェクト ファイルでプロパティを設定する必要があります。 .NET Framework プロジェクトのソース コード分析を無効にするには、「 .NET Framework プロジェクト」を参照してください。
ソース分析とレガシ分析
この記事は、従来の (バイナリ) 分析ではなく、ソース コード分析に適用されます。 レガシ分析を無効にする方法については、「 マネージド コードのバイナリ コード分析を有効または無効にする」を参照してください。
.NET Core、.NET Standard、および .NET 5 以降のプロジェクト
Visual Studio 2022 バージョン 17.0.4 以降では、[ コード分析 ] プロパティ ページに 2 つのチェック ボックスが表示され、アナライザーがビルド時とデザイン時に実行されるかどうかを制御できます。 プロジェクトでコード分析を無効にするには、次の手順に従います。
ソリューション エクスプローラーでプロジェクト ノードを右クリックし、[プロパティ] を選択します。
[コード分析] を選択します。
[ コード分析 ] プロパティ ページが開きます。
![[コード分析] プロパティ ページを示すスクリーンショット。](media/run-on-build-run-live-analysis-1.png?view=vs-2022)
ビルド時にソース分析を無効にするには、[ビルド時に実行] で [ビルド時に常にコード分析を実行する] をオフにします。
ライブ ソース分析を無効にするには、ライブ分析時に実行 の設定で、入力時にコード分析をエディターでライブ実行する のチェックを外します。
注
Visual Studio 2022 バージョン 17.0.4 以降では、オンデマンドコード分析実行ワークフローを使用する場合は、ライブ分析中にアナライザーの実行を無効にすることができます。 または、必要に応じてプロジェクトまたはソリューションでコード分析を 1 回ビルドして手動でトリガーすることもできます。 コード分析を手動で実行する方法については、「 .NET のコード分析を手動で実行する」を参照してください。
.NET Framework プロジェクト
アナライザーのソース コード分析を無効にするには、次の MSBuild プロパティの 1 つ以上を プロジェクト ファイルに追加します。
| MSBuild プロパティ | 説明 | 既定値 |
|---|---|---|
RunAnalyzersDuringBuild |
アナライザーがビルド時に実行されるかどうかを制御します。 | true |
RunAnalyzersDuringLiveAnalysis |
アナライザーがデザイン時にコードをライブで分析するかどうかを制御します。 | true |
RunAnalyzers |
このプロパティを false に設定すると、ビルド時とデザイン時の両方でアナライザーが無効になります。
RunAnalyzersDuringBuildとRunAnalyzersDuringLiveAnalysisよりも優先されます。 |
true |
例えば次が挙げられます。
<RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
<RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
<RunAnalyzers>false</RunAnalyzers>
このページでは、Visual Studio でコード分析を無効にすることができます。 無効にできる制限事項があり、コード分析をオフにする手順は、いくつかの要因によって異なります。
プロジェクトの種類 (.NET Core、.NET Standard、.NET 5 以降と .NET Framework)
.NET Core、.NET Standard、および .NET 5 以降のプロジェクトには、NuGet パッケージとしてインストールされているアナライザーからコード分析をオフにするためのオプションがあります。 詳細については、「 .NET Core、.NET Standard、.NET 5 以降のプロジェクト」を参照してください。 .NET Framework プロジェクトでソース コード分析を無効にする方法については、「 .NET Framework プロジェクト」を参照してください。
ソース分析とレガシ分析
この記事は、従来の (バイナリ) 分析ではなく、ソース コード分析に適用されます。 レガシ分析を無効にする方法については、「 マネージド コードのバイナリ コード分析を有効または無効にする」を参照してください。
.NET Core、.NET Standard、および .NET 5 以降のプロジェクト
Visual Studio 2019 バージョン 16.3 以降では、 コード分析 プロパティ ページに 2 つのチェック ボックスが用意されています。これにより、アナライザーをビルド時とデザイン時に実行するかどうかを制御できます。 これらのオプションはプロジェクト固有です。
![[コード分析] プロパティ ページを示すスクリーンショット。](media/run-on-build-run-live-analysis.png?view=vs-2022)
このページを開くには、 ソリューション エクスプローラー でプロジェクト ノードを右クリックし、[ プロパティ] を選択します。 [ コード分析 ] タブを選択します。
- ビルド時にソース分析を無効にするには、[ビルド時に 実行 ] オプションをオフにします。
- ライブ ソース分析を無効にするには、[ ライブ分析時に実行 ] オプションをオフにします。
注
Visual Studio 2019 バージョン 16.5 以降では、オンデマンドのコード分析実行ワークフローが必要な場合は、ライブ分析中にアナライザーの実行を無効にすることができます。 または、必要に応じてプロジェクトまたはソリューションでコード分析を 1 回ビルドして手動でトリガーすることもできます。 コード分析を手動で実行する方法については、「 .NET のコード分析を手動で実行する」を参照してください。
.NET Framework プロジェクト
アナライザーのソース コード分析を無効にするには、次の MSBuild プロパティの 1 つ以上を プロジェクト ファイルに追加します。
| MSBuild プロパティ | 説明 | 既定値 |
|---|---|---|
RunAnalyzersDuringBuild |
アナライザーがビルド時に実行されるかどうかを制御します。 | true |
RunAnalyzersDuringLiveAnalysis |
アナライザーがデザイン時にコードをライブで分析するかどうかを制御します。 | true |
RunAnalyzers |
このプロパティを false に設定すると、ビルド時とデザイン時の両方でアナライザーが無効になります。
RunAnalyzersDuringBuildとRunAnalyzersDuringLiveAnalysisよりも優先されます。 |
true |
例えば次が挙げられます。
<RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
<RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
<RunAnalyzers>false</RunAnalyzers>