Preferencias de declaración de espacio de nombres (IDE0160 e IDE0161)

  • Artículo

En este artículo se describen dos reglas relacionadas, IDE0160 y IDE0161.

Propiedad Value
Identificador de la regla IDE0160
Título Uso del espacio de nombres con ámbito de bloque
Categoría Estilo
Subcategoría Reglas del lenguaje (preferencias de bloques de código)
Lenguajes aplicables C#
Opciones csharp_style_namespace_declarations
Propiedad Value
Identificador de la regla IDE0161
Título Uso de espacios de nombres con ámbito de archivo
Categoría Estilo
Subcategoría Reglas del lenguaje (preferencias de bloques de código)
Lenguajes aplicables C#
Opciones csharp_style_namespace_declarations

Información general

Estas reglas se aplican a las declaraciones de espacio de nombres. Para que IDE0161 notifique infracciones cuando se usa el espacio de nombres de ámbito de bloque, la opción asociada debe establecerse en file_scoped.

Opciones

El valor de la opción especifica si las declaraciones de espacio de nombres deben estar en el ámbito de bloque o en el ámbito de archivo. De forma predeterminada, las declaraciones de espacio de nombres tienen ámbito de bloque. Visual Studio emplea esta opción para determinar cómo se declaran los espacios de nombres al agregarse los archivos de código a los proyectos. Visual Studio respeta el valor de opción incluso si están deshabilitados IDE0160 y IDE0161.

Para obtener información sobre la configuración de las opciones, consulte Formato de opción.

csharp_style_namespace_declarations

Propiedad Value Descripción
Nombre de la opción csharp_style_namespace_declarations
Lenguajes aplicables C#
Versión introducida Visual Studio 2019
Valores de opción block_scoped Las declaraciones de espacio de nombres deben tener ámbito de bloque.
file_scoped Las declaraciones de espacio de nombres deben tener ámbito de archivo.
Valor de opción predeterminado block_scoped 
// csharp_style_namespace_declarations = block_scoped
using System;

namespace Convention
{
    class C
    {
    }
}

// csharp_style_namespace_declarations = file_scoped
using System;

namespace Convention;
class C
{
}

Supresión de una advertencia

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

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

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

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

Para deshabilitar todas las reglas de estilo del código, establezca la gravedad de la categoría Style en none del archivo de configuración.

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

Para obtener más información, consulte Procedimiento para suprimir advertencias de análisis de código.

Consulte también