Share via

Preferências de declaração do espaço de nomes (IDE0160 e IDE0161)

  • Artigo

Este artigo descreve duas regras IDE0160 relacionadas e IDE0161.

Propriedade Valor
ID da Regra IDE0160
Título Utilizar o espaço de nomes com âmbito de bloco
Categoria Estilo
Subcategoria Regras de idioma (preferências de bloco de código)
Idiomas aplicáveis C#
Opções csharp_style_namespace_declarations
Propriedade Valor
ID da Regra IDE0161
Título Utilizar o espaço de nomes com âmbito de ficheiro
Categoria Estilo
Subcategoria Regras de idioma (preferências de bloco de código)
Idiomas aplicáveis C#
Opções csharp_style_namespace_declarations

Descrição Geral

Estas regras aplicam-se a declarações de espaço de nomes. Para IDE0161 comunicar violações quando são utilizados espaços de nomes com âmbito de bloco, tem de definir a opção associada como file_scoped.

Opções

O valor da opção especifica se as declarações do espaço de nomes devem ser no âmbito do bloco ou no âmbito do ficheiro. Por predefinição, as declarações do espaço de nomes estão no âmbito do bloco. Esta opção é utilizada pelo Visual Studio para determinar como os espaços de nomes são declarados quando são adicionados novos ficheiros de código aos projetos. O Visual Studio honra o valor da opção, mesmo que ambos IDE0160 e IDE0161 estejam desativados.

Para obter informações sobre como configurar opções, veja Formato de opção.

csharp_style_namespace_declarations

Propriedade Valor Descrição
Nome da opção csharp_style_namespace_declarations
Idiomas aplicáveis C#
Versão introduzida Visual Studio 2019
Valores de opção block_scoped As declarações de espaço de nomes devem estar no âmbito do bloco.
file_scoped As declarações de espaço de nomes devem estar no âmbito do ficheiro.
Valor de opção predefinido 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 quiser suprimir apenas uma única violação, adicione diretivas de pré-processamento ao ficheiro de origem para desativar e, em seguida, reativar 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 desativar a regra de um ficheiro, pasta ou projeto, defina a gravidade para none no ficheiro de configuração.

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

Para desativar todas as regras de estilo de código, defina a gravidade da categoria Style como none no ficheiro de configuração.

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

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

Ver também