CA1826: используйте свойство вместо метода Linq Enumerable

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

Причина

Метод LINQ Enumerable использовался для типа, поддерживающего эквивалентное и более эффективное свойство.

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

Это правило помечает Enumerable вызовы метода LINQ к коллекциям типов, которые имеют эквивалентные, но более эффективные свойства для получения одинаковых данных.

Это правило анализирует типы коллекций, реализующие IReadOnlyList<T> , но не IList<T>.

Это правило отмечает вызовы следующих методов для этих типов коллекций:

• System.Linq.Enumerable.Count
• System.Linq.Enumerable.First
• System.Linq.Enumerable.FirstOrDefault
• System.Linq.Enumerable.Last
• System.Linq.Enumerable.LastOrDefault

Проанализированные типы и методы коллекции могут быть расширены в будущем, чтобы охватывать больше случаев.

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

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

using System;
using System.Collections.Generic;
using System.Linq;

class C
{
    public void M(IReadOnlyList<string> list)
    {
        Console.Write(list.First());
        Console.Write(list.Last());
        Console.Write(list.Count());
    }
}

using System;
using System.Collections.Generic;

class C
{
    public void M(IReadOnlyList<string> list)
    {
        Console.Write(list[0]);
        Console.Write(list[list.Count - 1]);
        Console.Write(list.Count);
    }
}

Совет

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

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

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

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

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

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

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

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

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

Настройка кода для анализа

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

• Исключение методов FirstOrDefault и LastOrDefault

Исключение методов FirstOrDefault и LastOrDefault

Это правило можно настроить для исключения Enumerable.FirstOrDefault методов и Enumerable.LastOrDefault методов из анализа. Вы можете исключить эти методы, если возможность чтения является проблемой, так как код, который вы напишете для замены, не легко читаемый. Чтобы исключить эти методы, добавьте следующую пару "ключ-значение" в файл editorconfig в проекте:

dotnet_code_quality.CA1826.exclude_ordefault_methods = true

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

• CA1827: не используйте Count/LongCount, если можно использовать Any.
• CA1828: не используйте CountAsync/LongCountAsync при использовании AnyAsync
• CA1829: используйте свойство Length/Count вместо метода Enumerable.Count

См. также

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