Compartir a través de


Deshabilitación del análisis de código fuente para .NET

Visual Studio permite controlar si los analizadores de código fuente se ejecutan en tiempo de compilación y tiempo de diseño. Hay limitaciones en lo que puede deshabilitar y el procedimiento para desactivar el análisis de código difiere en función de algunos factores:

  • Tipo de proyecto (.NET Core, .NET Standard y .NET 5+ frente a .NET Framework)

    Los proyectos de .NET Core, .NET Standard y .NET 5+ tienen opciones en su página de propiedades de análisis de código que permiten desactivar el análisis de código de los analizadores instalados como un paquete NuGet. Para obtener más información, vea Proyectos de .NET Core, .NET Standard y .NET 5+. Por el contrario, los proyectos de .NET Framework requieren que establezca propiedades en el archivo de proyecto. Para desactivar el análisis de código fuente para proyectos de .NET Framework, consulte Proyectos de .NET Framework.

  • Análisis de origen frente a análisis heredado

    Este artículo se aplica al análisis de código fuente y no al análisis heredado (binario). Para obtener información sobre cómo deshabilitar el análisis heredado, consulte Habilitación y deshabilitación del análisis de código binario para código administrado.

Proyectos de .NET Core, .NET Standard y .NET 5+

Visual Studio 2022, versión 17.0.4 y posteriores, proporciona dos casillas en la página de propiedades de Análisis de Código para controlar si los analizadores se ejecutan en tiempo de compilación y en tiempo de diseño. Para deshabilitar el análisis de código en el proyecto, siga estos pasos:

  1. Haga clic con el botón derecho en el nodo del proyecto en el Explorador de soluciones y, a continuación, seleccione Propiedades.

  2. Selecciona Análisis de código.

    Se abre la página de propiedades Análisis de Código.

    Captura de pantalla que muestra la página de propiedades de Análisis de código.

  3. Para deshabilitar el análisis de código fuente en tiempo de compilación, en Ejecutar en compilación, desactive Ejecutar siempre el análisis de código en la compilación.

  4. Para deshabilitar el análisis del código fuente en vivo, en Ejecutar el análisis en directo, desactive Ejecutar el análisis de código en directo en el editor mientras teclea.

Nota:

A partir de la versión 17.0.4 de Visual Studio 2022, si prefiere el flujo de trabajo de ejecución de análisis de código a petición, puede deshabilitar la ejecución del analizador durante el análisis en directo. O bien, puede compilar y desencadenar manualmente el análisis de código una vez en un proyecto o una solución a petición. Para obtener información sobre cómo ejecutar el análisis de código manualmente, consulte Ejecución manual del análisis de código para .NET.

Proyectos de .NET Framework

Para desactivar el análisis de código fuente de los analizadores, agregue una o varias de las siguientes propiedades de MSBuild al archivo del proyecto.

Propiedad de MSBuild Descripción Predeterminado
RunAnalyzersDuringBuild Controla si los analizadores se ejecutan en tiempo de compilación. true
RunAnalyzersDuringLiveAnalysis Controla si los analizadores analizan el código en tiempo real en tiempo de diseño. true
RunAnalyzers Al establecer esta propiedad en false se deshabilitan los analizadores en tiempo de compilación y diseño. Tiene prioridad sobre RunAnalyzersDuringBuild y RunAnalyzersDuringLiveAnalysis. true

Por ejemplo:

<RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
<RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
<RunAnalyzers>false</RunAnalyzers>

Esta página le permite deshabilitar el análisis de código en Visual Studio. Hay limitaciones en lo que puede deshabilitar y el procedimiento para desactivar el análisis de código difiere en función de algunos factores:

  • Tipo de proyecto (.NET Core, .NET Standard y .NET 5+ frente a .NET Framework)

    Los proyectos de .NET Core, .NET Standard y .NET 5+ tienen opciones en su página de propiedades de análisis de código que permiten desactivar el análisis de código de los analizadores instalados como un paquete NuGet. Para obtener más información, vea Proyectos de .NET Core, .NET Standard y .NET 5+. Para obtener información sobre cómo desactivar el análisis de código fuente en proyectos de .NET Framework, vea Proyectos de .NET Framework.

  • Análisis de origen frente a análisis heredado

    Este artículo se aplica al análisis de código fuente y no al análisis heredado (binario). Para obtener información sobre cómo deshabilitar el análisis heredado, consulte Habilitación y deshabilitación del análisis de código binario para código administrado.

Proyectos de .NET Core, .NET Standard y .NET 5+

Visual Studio 2019, versión 16.3 y posteriores, proporciona dos casillas en la página de propiedades de Análisis de Código que le permiten controlar si los analizadores se ejecutan en tiempo de compilación y de diseño. Estas opciones son específicas del proyecto.

Captura de pantalla que muestra la página de propiedades de Análisis de código.

Para abrir esta página, haga clic con el botón derecho en el nodo del proyecto en el Explorador de soluciones y seleccione Propiedades. Seleccione la pestaña Análisis de código .

  • Para deshabilitar el análisis de origen en tiempo de compilación, desactive la opción Ejecutar en compilación .
  • Para deshabilitar el análisis de código fuente en vivo, desactive la opción Ejecutar en análisis en vivo.

Nota:

A partir de la versión 16.5 de Visual Studio 2019, si prefiere el flujo de trabajo de ejecución de análisis de código a petición, puede deshabilitar la ejecución del analizador durante el análisis en directo. O bien, puede compilar y desencadenar manualmente el análisis de código una vez en un proyecto o una solución a petición. Para obtener información sobre cómo ejecutar el análisis de código manualmente, consulte Ejecución manual del análisis de código para .NET.

Proyectos de .NET Framework

Para desactivar el análisis de código fuente de los analizadores, agregue una o varias de las siguientes propiedades de MSBuild al archivo del proyecto.

Propiedad de MSBuild Descripción Predeterminado
RunAnalyzersDuringBuild Controla si los analizadores se ejecutan en tiempo de compilación. true
RunAnalyzersDuringLiveAnalysis Controla si los analizadores analizan el código en tiempo real en tiempo de diseño. true
RunAnalyzers Al establecer esta propiedad en false se deshabilitan los analizadores en tiempo de compilación y diseño. Tiene prioridad sobre RunAnalyzersDuringBuild y RunAnalyzersDuringLiveAnalysis. true

Por ejemplo:

<RunAnalyzersDuringBuild>false</RunAnalyzersDuringBuild>
<RunAnalyzersDuringLiveAnalysis>false</RunAnalyzersDuringLiveAnalysis>
<RunAnalyzers>false</RunAnalyzers>