Préférences de déclaration d’espace de noms (IDE0160 et IDE0161)

  • Article

Cet article décrit deux règles associées, IDE0160 et IDE0161.

Propriété Value
Identificateur de la règle IDE0160
Titre Utiliser un espace de noms étendu à un bloc
Catégorie Style
Sous-catégorie Règles du langage (préférences relatives aux blocs de code)
Langages applicables C#
Options csharp_style_namespace_declarations
Propriété Value
Identificateur de la règle IDE0161
Titre Utiliser un espace de noms étendu à un fichier
Catégorie Style
Sous-catégorie Règles du langage (préférences relatives aux blocs de code)
Langages applicables C#
Options csharp_style_namespace_declarations

Vue d’ensemble

Ces règles s’appliquent aux déclarations d’espace de noms. Pour que IDE0161 signale des violations quand des espaces de noms étendus à un bloc sont utilisés, vous devez définir l’option associée sur file_scoped.

Options

La valeur de l’option spécifie si les déclarations d’espace de noms doivent être étendues à un bloc ou à un fichier. Par défaut, les déclarations d’espace de noms sont étendues à un bloc. Cette option est utilisée par Visual Studio pour déterminer comment les espaces de noms sont déclarés quand de nouveaux fichiers de code sont ajoutés aux projets. Visual Studio respecte la valeur d’option même si IDE0160 et IDE0161 sont désactivés.

Pour plus d’informations sur la configuration des options, consultez Format d’option.

csharp_style_namespace_declarations

Propriété Valeur Description
Nom d'option csharp_style_namespace_declarations
Langages applicables C#
Version introduite Visual Studio 2019
Valeurs d’option block_scoped Les déclarations d’espace de noms doivent être étendues à un bloc.
file_scoped Les déclarations d’espace de noms doivent être étendues à un fichier.
Valeur d’option par défaut 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
{
}

Supprimer un avertissement

Si vous voulez supprimer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver et réactiver la règle.

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

Pour désactiver la règle sur un fichier, un dossier ou un projet, définissez sa gravité sur none dans le fichier de configuration.

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

Pour désactiver toutes les règles de style de code, définissez la gravité de la catégorie Style sur none dans le fichier de configuration.

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

Pour plus d’informations, consultez Comment supprimer les avertissements de l’analyse de code.

Voir aussi