Поделиться через


Параметры объявления пространства имен (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

Дополнительные сведения см. в статье Подавление предупреждений анализа кода.

См. также