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


CA1713: имена событий не должны содержать префикс "before" или "after"

Свойство Значение
Идентификатор правила CA1713
Заголовок События не должны иметь префикс before или after
Категория Именование
Исправление является критическим или не критическим Критическое
Включен по умолчанию в .NET 10 No

Причина

Имя события начинается с Before или After.

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

Имена событий должны описывать действие, которое вызывает событие. Чтобы дать имена связанным событиям, возникающим в определенной последовательности, используйте настоящее или прошедшее время, чтобы обозначить положение события в последовательности действий. Например, при именовании пары событий, создаваемых при закрытии ресурса, можно присвоить имя "Closing" и "Closed" вместо "BeforeClose" и "AfterClose".

Соглашения об именовании обеспечивают единство вида библиотек, предназначенных для среды CLR. Это сокращает время, необходимое для изучения новых библиотек программного обеспечения, и позволяет клиентам увериться в том, что разработчик библиотеки имеет опыт разработки управляемого кода.

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

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

Example

public class Session
{
    // This code violates the rule.
    public event EventHandler? BeforeClose;
    public event EventHandler? AfterClose;

    // This code satisfies the rule.
    public event EventHandler? Closing;
    public event EventHandler? Closed;
}

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

Для этого правила отключать вывод предупреждений не следует.