Бөлісу құралы:

CA2264: не передавайте ненулевое значение в ArgumentNullException.ThrowIfNull.

Свойство Значение
Идентификатор правила CA2264
Заголовок Не передайте ненулевое значение в ArgumentNullException.ThrowIfNull
Категория Использование
Исправление является критическим или не критическим неразрывный
Включен по умолчанию в .NET 10 Как предупреждение
Применимые языки C# и Visual Basic

Причина

Значение, которое заведомо никогда не бывает NULL, передается в ArgumentNullException.ThrowIfNull().

Описание правила

ArgumentNullException.ThrowIfNull выбрасывается, когда переданный аргумент null. Некоторые конструкции, такие как структуры, не допускающие значение NULL (за исключением Nullable<T>), параметры типа, известные как структуры, не допускающие значения NULL, выражения nameof(), и выражения new, как известно, никогда не будут иметь значение NULL, поэтому ArgumentNullException.ThrowIfNull никогда не будет вызываться. Таким образом, вызов ArgumentNullException.ThrowIfNull не требуется.

В случае структуры, так как ArgumentNullException.ThrowIfNull принимает object? как параметр, структура упаковывается, что приводит к дополнительным потерям производительности.

Устранение нарушений

ArgumentNullException.ThrowIfNull Удалите звонок.

Пример

В следующем фрагменте кода показано нарушение CA2264:

static void Print(int value)
{
    ArgumentNullException.ThrowIfNull(value);
    Console.WriteLine(value);
}

Следующий фрагмент кода исправляет нарушение.

static void Print(int value)
{
    Console.WriteLine(value.Value);
}

Когда лучше отключить предупреждения

Это предупреждение всегда безопасно игнорировать.

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

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

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

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

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

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

См. также

  • Last updated on