Параметры объявления пространства имен (IDE0160 и IDE0161)

  • Статья

В этой статье описываются два связанных правила: IDE0160 и IDE0161.

Свойство Значение
Идентификатор правила IDE0160
Заголовок Использование пространства имен с блочного уровня
Категория Стиль
Подкатегория Языковые правила (параметры блока кода)
Применимые языки C#
Параметры csharp_style_namespace_declarations
Свойство Значение
Идентификатор правила IDE0161
Заголовок Использование пространства имен с областью действия файла
Категория Стиль
Подкатегория Языковые правила (параметры блока кода)
Применимые языки C#
Параметры csharp_style_namespace_declarations

Общие сведения

Эти правила применяются к объявлениям пространств имен. Чтобы IDE0161 сообщать о нарушениях при использовании блочных пространств имен, необходимо задать для связанного параметра значение file_scoped.

Варианты

Значение параметра указывает, должны ли объявления пространств имен быть блочной или файловой. По умолчанию объявления пространств имен имеют блочный диапазон. Этот параметр используется Visual Studio для определения того, как объявляются пространства имен при добавлении новых файлов кода в проекты. Visual Studio учитывает значение параметра, даже если оба IDE0160 параметра и IDE0161 отключены.

Сведения о настройке параметров см. в разделе Формат параметров.

csharp_style_namespace_declarations

Свойство Значение Описание
Имя параметра 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

Чтобы отключить все правила в стиле кода, задайте серьезность для категории Stylenone в файле конфигурации.

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

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

См. также раздел