[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Returns the EventInfo object representing the specified public event.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Parameters
- name
- Type: System.String
The string containing the name of an event that is declared or inherited by the current Type.
Return Value
Type: System.Reflection.EventInfoThe object representing the specified public event that is declared or inherited by the current Type, if found; otherwise, Nothing.
Implements
_Type.GetEvent(String)| Exception | Condition |
|---|---|
| ArgumentNullException |
name is Nothing. |
An event is considered public to reflection if it has at least one method or accessor that is public. Otherwise the event is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.
The search for name is case-sensitive. The search includes public static and public instance events.
The following table shows what members of a base class are returned by the Get methods when reflecting on a type.
|
Member Type |
Static |
Non-Static |
|---|---|---|
|
Constructor |
No |
No |
|
Field |
No |
Yes. A field is always hide-by-name-and-signature. |
|
Event |
Not applicable |
The common type system rule is that the inheritance is the same as that of the methods that implement the property. Reflection treats properties as hide-by-name-and-signature. See note 2 below. |
|
Method |
No |
Yes. A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature. |
|
Nested Type |
No |
No |
|
Property |
Not applicable |
The common type system rule is that the inheritance is the same as that of the methods that implement the property. Reflection treats properties as hide-by-name-and-signature. See note 2 below. |
-
Hide-by-name-and-signature considers all of the parts of the signature, including custom modifiers, return types, parameter types, sentinels, and unmanaged calling conventions. This is a binary comparison.
-
For reflection, properties and events are hide-by-name-and-signature. If you have a property with both a get and a set accessor in the base class, but the derived class has only a get accessor, the derived class property hides the base class property, and you will not be able to access the setter on the base class.
-
Custom attributes are not part of the common type system.
If the current Type represents a constructed generic type, this method returns the EventInfo with the type parameters replaced by the appropriate type arguments.
If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the events of the class constraint.
The following example creates an EventInfo object and gets the event for a button class for the specified event.
using System; using System.Reflection; using System.Security; class MyEventExample { public static void Main() { try { Type myType = typeof(System.Windows.Forms.Button); EventInfo myEvent = myType.GetEvent("Click"); if(myEvent != null) { Console.WriteLine("Looking for the Click event in the Button class."); Console.WriteLine(myEvent.ToString()); } else Console.WriteLine("The Click event is not available in the Button class."); } catch(SecurityException e) { Console.WriteLine("An exception occurred."); Console.WriteLine("Message :"+e.Message); } catch(ArgumentNullException e) { Console.WriteLine("An exception occurred."); Console.WriteLine("Message :"+e.Message); } catch(Exception e) { Console.WriteLine("The following exception was raised : {0}",e.Message); } } }
Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

