Параметры объявления пространства имен (IDE0160 и IDE0161)
В этой статье описаны два связанных правила, IDE0160
и IDE0161
.
Недвижимость / Собственность (if context requires) | Ценность |
---|---|
идентификатор правила | IDE0160 |
Заголовок | Используйте блочное пространство имен |
категории | Стиль |
подкатегория | Языковые правила (настройки блока кода) |
применимые языки | C# |
параметры | csharp_style_namespace_declarations |
Свойство | Ценность |
---|---|
идентификатор правила | IDE0161 |
Заголовок | Использование пространства имен с областью действия файла |
Категория | Стиль |
Подкатегория | Языковые правила (настройки блока кода) |
применимые языки | C# |
Опции | csharp_style_namespace_declarations |
Обзор
Эти правила применяются к объявлениям пространства имен . Чтобы IDE0161
сообщать о нарушениях при использовании пространств имен с блочной областью видимости, необходимо установить соответствующий параметр в file_scoped
.
Настройки
Значение параметра указывает, должны ли объявления пространства имен иметь область действия блока или файла. По умолчанию объявления пространства имен имеют блочную видимость. Этот параметр используется Visual Studio для определения того, как объявляются пространства имен при добавлении новых файлов кода в проекты. Visual Studio учитывает значение опции, даже если оба IDE0160
и IDE0161
отключены.
Для получения сведений о настройке параметров см. Формат параметра.
Стиль объявлений пространства имен C#
Свойство | Ценность | Описание |
---|---|---|
имя параметра | csharp_style_namespace_declarations | |
применимые языки | C# | |
появилась версия | Visual Studio 2019 | |
значения опций | block_scoped |
Объявления пространства имен должны иметь блочную область видимости. |
file_scoped |
Объявления пространства имен должны быть ограничены областью действия файла. | |
значение параметра по умолчанию | 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
{
}
Подавление предупреждения
Если вы хотите отключить только одно нарушение, добавьте директивы препроцессора в исходный файл, чтобы отключить и повторно включить правило.
#pragma warning disable IDE0160 // Or IDE0161
// The code that's violating the rule is on this line.
#pragma warning restore IDE0160 // Or IDE0161
Чтобы отключить правило для файла, папки или проекта, задайте его серьезность none
в файле конфигурации .
[*.{cs,vb}]
dotnet_diagnostic.IDE0160.severity = none
dotnet_diagnostic.IDE0161.severity = none
Чтобы отключить все правила стиля кода, установите уровень серьезности категории с Style
на none
в файле конфигурации .
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
Дополнительные сведения см. в статье Подавление предупреждений анализа кода.
См. также
- Объявления пространства имён (C#)
- правил языка стиля кода
- справочник по правилам стиля кода