Предпочтения var (IDE0007 и IDE0008)

  • Статья

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

Свойство Значение
Идентификатор правила IDE0007
Заголовок Использование var вместо явного типа
Категория Стиль
Подкатегория Языковые правила (предпочтения var)
Применимые языки C#
Параметры csharp_style_var_for_built_in_types
csharp_style_var_when_type_is_apparent
csharp_style_var_elsewhere
Свойство Значение
Идентификатор правила IDE0008
Заголовок Использование явного типа вместо var
Категория Стиль
Подкатегория Языковые правила (предпочтения var)
Применимые языки C#
Параметры csharp_style_var_for_built_in_types
csharp_style_var_when_type_is_apparent
csharp_style_var_elsewhere

Обзор

Эти два правила стиля определяют, следует ли использовать ключевое слово var или явный тип в объявлении переменной. Чтобы применить это var значение, задайте серьезность IDE0007 предупреждения или ошибки. Чтобы обеспечить использование явного типа, задайте серьезность IDE0008 предупреждения или ошибки.

Варианты

Связанные с этим правилом параметры определяют, где следует применять этот стиль:

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

csharp_style_var_for_built_in_types

Свойство Значение Описание
Имя параметра csharp_style_var_for_built_in_types
Значения параметра true Предпочтительное var использование для объявления переменных со встроенными системными типами, такими как int
false Предпочитать явный тип объявлять var переменные со встроенными системными типами, такими как int
Значение параметра по умолчанию false 
// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

csharp_style_var_when_type_is_apparent

Свойство Значение Описание
Имя параметра csharp_style_var_when_type_is_apparent
Значения параметра true Предпочитать var , если тип уже упоминается в правой части выражения объявления
false Предпочитать явный тип, если тип уже упоминается в правой части выражения объявления
Значение параметра по умолчанию false 
// csharp_style_var_when_type_is_apparent = true
var obj = new Customer();

// csharp_style_var_when_type_is_apparent = false
Customer obj = new Customer();

csharp_style_var_elsewhere

Свойство Значение Описание
Имя параметра csharp_style_var_elsewhere
Значения параметра true Предпочитать var явный тип во всех случаях, если только не переопределяется другим правилом стиля кода
false Предпочитать явный тип во var всех случаях, если только не переопределяется другим правилом стиля кода
Значение параметра по умолчанию false 
// csharp_style_var_elsewhere = true
var f = this.Init();

// csharp_style_var_elsewhere = false
bool f = this.Init();

Отключение предупреждений

Если вы хотите отключить только одно нарушение, добавьте директивы препроцессора в исходный файл, чтобы отключить и повторно включить правило.

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

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

[*.{cs,vb}]
dotnet_diagnostic.IDE0007.severity = none
dotnet_diagnostic.IDE0008.severity = none

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

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

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

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