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


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

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

Причина

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

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

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

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

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

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

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

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