Eliminación de la supresión innecesaria (IDE0079)

Artículo
01/01/2025

Propiedad	Valor
de identificador de regla	IDE0079
título de	Eliminación de la supresión innecesaria
categoría	CodeQuality
subcategoría de	Reglas de código innecesarias (preferencias de supresión)
idiomas aplicables	C# y Visual Basic
Opciones	`dotnet_remove_unnecessary_suppression_exclusions`

Visión general

Esta regla marca las pragma innecesarias y las supresiones de atributos SuppressMessageAttribute en el origen.

Las supresiones de origen suprimen las infracciones de las reglas del compilador y del analizador en lugares específicos, pero no en otras partes del código fuente. Por lo general, los usa para suprimir falsos positivos o infracciones menos importantes que no pretende corregir. Sin embargo, las supresiones a menudo se vuelven obsoletas. Esto puede ocurrir si se ha corregido una regla para evitar falsos positivos o refactorizar el código y, al hacerlo, representar las supresiones redundantes. Esta regla ayuda a identificar las supresiones redundantes, que se pueden quitar.

Nota

Incluso si habilitar reglas de estilo de código en la compilación, esta regla no está habilitada. Solo se muestra en el editor de Visual Studio.

Ejemplo

using System.Diagnostics.CodeAnalysis;

class C1
{
    // Necessary pragma suppression
#pragma warning disable IDE0051 // IDE0051: Remove unused member
    private int UnusedMethod() => 0;
#pragma warning restore IDE0051

    // IDE0079: Unnecessary pragma suppression
#pragma warning disable IDE0051 // IDE0051: Remove unused member
    private int UsedMethod() => 0;
#pragma warning restore IDE0051

    public int PublicMethod() => UsedMethod();
}

class C2
{
    // Necessary SuppressMessage attribute suppression
    [SuppressMessage("CodeQuality", "IDE0051:Remove unused private members", Justification = "<Pending>")]
    private int _unusedField;

    // IDE0079: Unnecessary SuppressMessage attribute suppression
    [SuppressMessage("CodeQuality", "IDE0051:Remove unused private members", Justification = "<Pending>")]
    private int _usedField;

    public int PublicMethod2() => _usedField;
}

Opciones

Las opciones especifican el comportamiento que desea que aplique la regla. Para obtener información sobre cómo configurar opciones, vea Formato de opción.

Nota

Establecer una gravedad en el formato option_name = value:severity no se aplica a la opción dotnet_remove_unnecessary_suppression_exclusions y debe evitarse. En su lugar, especifique la gravedad mediante una entrada independiente, por ejemplo:

dotnet_remove_unnecessary_suppression_exclusions = none
dotnet_diagnostic.IDE0079.severity = warning

dotnet_remove_unnecessary_suppression_exclusions

Propiedad	Valor	Descripción
nombre de opción	dotnet_remove_unnecessary_suppression_exclusions
valores de opción	Lista separada por comas de identificadores de regla o categorías (prefijos con `category:`)	Excluye las supresiones de las reglas o categorías enumeradas.
	`all`	Deshabilita la regla (todos los identificadores de regla excluidos)
	`none`	Habilita la regla para todas las reglas (sin exclusiones)
valor de opción predeterminado	`none`

using System.Diagnostics.CodeAnalysis;

class C1
{
    // 'dotnet_remove_unnecessary_suppression_exclusions = IDE0051'

    // Unnecessary pragma suppression, but not flagged by IDE0079
#pragma warning disable IDE0051 // IDE0051: Remove unused member
    private int UsedMethod() => 0;
#pragma warning restore IDE0051

    public int PublicMethod() => UsedMethod();
}

Suprimir una advertencia

Si desea suprimir solo una infracción, agregue directivas de preprocesador al archivo de origen para deshabilitar y volver a habilitar la regla.

#pragma warning disable IDE0079
// The code that's violating the rule is on this line.
#pragma warning restore IDE0079

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad en none en el archivo de configuración de .

[*.{cs,vb}]
dotnet_diagnostic.IDE0079.severity = none

Para deshabilitar esta categoría completa de reglas, establezca la gravedad de la categoría en none en el archivo de configuración de .

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-CodeQuality.severity = none

Para obtener más información, vea Cómo suprimir advertencias de análisis de código.

Compartir a través de