CA1825: избегайте выделения массива нулевой длины

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

Причина

Выделен пустой массив Array без элементов.

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

Инициализация массива нулевой длины приводит к излишнему выделению памяти. Вместо этого используйте статический выделенный экземпляр пустого массива путем вызова метода Array.Empty. Выделение памяти является общим для всех вызовов этого метода.

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

Чтобы устранить нарушение, замените выделение массива нулевой длины вызовом Array.Empty. В следующих двух фрагментах кода показано нарушение правила и способы его устранения:

class C
{
    public void M1()
    {
        // Violates rule CA1825.
        var a = new int[0];
    }
}

class C
{
    public void M1()
    {
        // Resolves rule CA1825 violation.
        var a = System.Array.Empty<int>();
    }
}

Совет

Для этого правила в Visual Studio доступно исправление кода. Чтобы использовать его, поместите курсор на выделение массива и нажмите клавиши CTRL+ (период). В появившемся списке выберите Используйте Array.Empty.

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

Нарушение этого правила можно безопасно игнорировать, если вас не беспокоит дополнительное выделение памяти.

Примечание.

В этом правиле могут отображаться предупреждения о ложноположительных срабатываниях, если применяются все указанные ниже действия.

• Вы используете Visual Studio 2022 версии 17.5 или более поздней версии с более старой версией пакета SDK для .NET, то есть .NET 6 или более ранней версии.
• Вы используете анализаторы из пакета SDK для .NET 6 или более старой версии пакетов анализатора, например Microsoft.CodeAnalysis.FxCopAnalyzers.
• Вы используете массив нулевой длины в качестве аргумента атрибута, чаще всего в качестве параметра params.

Ложные срабатывания обусловлены критическим изменением компилятора C#. Рассмотрите возможность использования более нового анализатора, содержащего исправление для предупреждений о ложных срабатываниях. Обновление до Microsoft.CodeAnalysis.NetAnalyzers версии 7.0.0-preview1.22464.1 или более поздней версии или использование анализаторов из пакета SDK для .NET 7.

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

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

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

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

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

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

Связанные правила

• CA1814: используйте ступенчатые массивы вместо многомерных

См. также

• Правила производительности