Использование строкового литерала UTF-8 (IDE0230)

Статья
07/21/2023

Свойство	Значение
Идентификатор правила	IDE0230
Заголовок	Использование строкового литерала UTF-8
Категория	Стиль
Подкатегория	Правила языка (настройки уровня выражения)
Применимые языки	C# 11+
Параметры	`csharp_style_prefer_utf8_string_literals`

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

Это правило помечает использование массива байтов (byte[]), где можно использовать строковый литерал UTF-8 . Использование строкового литерала UTF-8 добавляет ясность в объявление.

Варианты

Параметры определяют поведение, которое требуется применить правилом. Сведения о настройке параметров см. в разделе Формат параметра.

csharp_style_prefer_utf8_string_literals

Свойство	Значение	Описание
Имя параметра	csharp_style_prefer_utf8_string_literals
Значения параметра	`true`	Предпочитать строковые литералы UTF-8 массивам байтов.
	`false`	Отключает проблемное правило.
Значение параметра по умолчанию	`true`

Пример

// Code with violations.
ReadOnlySpan<byte> _ = new byte[] { 65, 66, 67 };

// Fixed code.
ReadOnlySpan<byte> _ = "ABC"u8;

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

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

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

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

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

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

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

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

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