CA1009: Declare event handlers correctly


The new home for Visual Studio documentation is Visual Studio 2017 Documentation on

The latest version of this topic can be found at CA1009: Declare event handlers correctly.

|Breaking Change|Breaking|

A delegate that handles a public or protected event does not have the correct signature, return type, or parameter names.

Event handler methods take two parameters. The first is of type System.Object and is named 'sender'. This is the object that raised the event. The second parameter is of type System.EventArgs and is named 'e'. This is the data that is associated with the event. For example, if the event is raised whenever a file is opened, the event data typically contains the name of the file.

Event handler methods should not return a value. In the C# programming language, this is indicated by the return type void. An event handler can invoke multiple methods in multiple objects. If the methods were allowed to return a value, multiple return values would occur for each event, and only the value of the last method that was invoked would be available.

To fix a violation of this rule, correct the signature, return type, or parameter names of the delegate. For details, see the following example.

Do not suppress a warning from this rule.

The following example shows a delegate that is suited to handling events. The methods that can be invoked by this event handler comply with the signature that is specified in the Design Guidelines. AlarmEventHandler is the type name of the delegate. AlarmEventArgs derives from the base class for event data, EventArgs, and holds alarm event data.

Imports System

Namespace DesignLibrary

   Public Delegate Sub AlarmEventHandler(sender As Object, e As AlarmEventArgs)
   Public Class AlarmEventArgs
      Inherits EventArgs
   End Class
End Namespace

CA2109: Review visible event handlers

NIB: Events and Delegates