Preferências de declaração de namespace (IDE0160 e IDE0161)

  • Artigo

Este artigo descreve duas regras relacionadas, IDE0160 e IDE0161.

Propriedade Valor
ID da regra IDE0160
Título Usar namespace com escopo de bloco
Categoria Estilo
Subcategoria Regras de idioma (preferências de bloco de código)
Linguagens aplicáveis C#
Opções csharp_style_namespace_declarations
Propriedade Valor
ID da regra IDE0161
Título Usar namespace com escopo de arquivo
Categoria Estilo
Subcategoria Regras de idioma (preferências de bloco de código)
Linguagens aplicáveis C#
Opções csharp_style_namespace_declarations

Visão geral

Essas regras se aplicam a declarações de namespace. Para IDE0161 relatar violações quando namespaces com escopo de bloco são usados, você deve definir a opção associada como file_scoped.

Opções

O valor da opção especifica se as declarações de namespace devem ter escopo de bloco ou escopo de arquivo. Por padrão, as declarações de namespace têm escopo de bloco. Essa opção é usada pelo Visual Studio para determinar como os namespaces são declarados quando novos arquivos de código são adicionados a projetos. O Visual Studio honra o valor da opção mesmo que tanto IDE0160 quanto IDE0161 esteja desabilitado.

Para obter informações sobre como configurar as opções, confira Formato da opção.

csharp_style_namespace_declarations

Propriedade Valor Descrição
Nome da opção csharp_style_namespace_declarations
Linguagens aplicáveis C#
Versão introduzida Visual Studio 2019
Valores da opção block_scoped As declarações de namespace devem estar no escopo do bloco.
file_scoped As declarações de namespace devem ter o escopo do arquivo.
Valor da opção padrão 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
{
}

Suprimir um aviso

Se você quiser suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem para desabilitar e, em seguida, reabilite a regra.

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

Para desabilitar a regra em um arquivo, uma pasta ou um projeto, defina a severidade como none no arquivo de configuração.

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

Para desabilitar todas as regras de estilo de código, defina a severidade da categoria Style como none no arquivo de configuração.

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

Para obter mais informações, confira Como suprimir avisos de análise de código.

Confira também