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

CA1030: используйте события, если это уместно

  • Статья

TypeName

UseEventsWhereAppropriate

CheckId

CA1030

Категория

Microsoft.Design

Критическое изменение

Не критическое

Причина

Имя открытого, защищенного или закрытого метода начинается со следующих лексем:

  • AddOn

  • RemoveOn

  • Fire

  • Raise

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

Данное правило отслеживает методы с именами, которые, как правило, используются для событий. События основаны на шаблоне разработки "Observer" или "Publish-Subscribe"; они используются в ситуациях, когда об изменении состояния одного объекта требуется сообщить другим объектам. Если метод вызывается в ответ на четко определенное изменение состояния, то этот вызов должен осуществляться с помощью обработчика событий. Объекты, вызывающие методы, должны создавать события, а не вызывать методы напрямую.

Некоторые наиболее распространенные события реализуются в приложениях пользовательского интерфейса, в которых действия пользователя, такие как нажатие кнопки, приводят к выполнению фрагмента кода. Модель событий .NET Framework не ограничивается пользовательскими интерфейсами; ее следует использовать во всех случаях, когда необходимо сообщить одному или нескольким объектам об изменении состояния.

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

Если метод вызывается при изменении состояния объекта, следует изменить структуру кода и использовать модель событий .NET Framework.

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

Если метод не работает с моделью событий .NET Framework, предупреждения о нарушении данного правила следует отключить.