Type.GetEvent (Método) (String)
Ensamblado: mscorlib (en mscorlib.dll)
public final EventInfo GetEvent ( String name )
public final function GetEvent ( name : String ) : EventInfo
Parámetros
Valor devuelto
Objeto EventInfo que representa el evento público especificado que la clase Type actual declara o hereda, si se encuentra; de lo contrario es referencia de objeto null (Nothing en Visual Basic).La búsqueda de name distingue entre mayúsculas y minúsculas. La búsqueda incluye eventos estáticos públicos y eventos de instancia pública.
Si el tipo solicitado no es público y el llamador no tiene una clase ReflectionPermission para reflejar objetos no públicos fuera del ensamblado actual, este método devuelve referencia de objeto null (Nothing en Visual Basic).
En la tabla siguiente se muestra qué miembros de una clase base devuelven los métodos Get cuando se reflejan en un tipo.
| Tipo de miembro | Estático | No estático |
|---|---|---|
| Constructor | No | No |
| Campo | No | Sí. Un campo siempre está oculto por nombre y firma. |
| Evento | No es aplicable | Según la regla del sistema de tipos comunes, la herencia es la misma que la de los métodos que implementan la propiedad. La reflexión trata las propiedades de acuerdo con la regla "Ocultar por nombre y firma". Vea la nota 2. |
| Método | No | Sí. Cualquier método (tanto virtual como no virtual) puede estar oculto por nombre o por nombre y firma. |
| Tipo anidado | No | No |
| Propiedad | No es aplicable | Según la regla del sistema de tipos comunes, la herencia es la misma que la de los métodos que implementan la propiedad. La reflexión trata las propiedades de acuerdo con la regla "Ocultar por nombre y firma". Vea la nota 2. |
-
La regla "Ocultar por nombre y firma" tiene en cuenta todas las partes de la firma, incluidos los modificadores personalizados, los tipos de valores devueltos, los tipos de parámetros, los centinelas y las convenciones de llamada no administradas. Se trata de una comparación binaria.
-
En el caso de la reflexión, las propiedades y los eventos están ocultos por nombre y firma. Si existe una propiedad con un descriptor de acceso get y otro set en la clase base, pero la clase derivada sólo tiene un descriptor de acceso get, la propiedad de la clase derivada oculta la propiedad de la clase base y no se podrá obtener acceso al descriptor de acceso set de la clase base.
-
Los atributos personalizados no forman parte del sistema de tipos comunes.
Si el objeto Type actual representa un tipo genérico construido, este método devuelve EventInfo con los parámetros de tipo sustituidos por los argumentos de tipo adecuados.
Si el objeto Type actual representa un parámetro de tipo en la definición de un tipo genérico o de un método genérico, este método busca los eventos de la restricción de clase.
En el siguiente ejemplo se crea un objeto EventInfo y se obtiene el evento de una clase Button correspondiente al evento especificado.
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); } } }
import System.*;
import System.Reflection.*;
import System.Security.*;
class MyEventExample
{
public static void main(String[] args)
{
try {
Type myType = System.Windows.Forms.Button.class.ToType();
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.get_Message());
}
catch (ArgumentNullException e) {
Console.WriteLine("An exception occurred.");
Console.WriteLine("Message :" + e.get_Message());
}
catch (System.Exception e) {
Console.WriteLine("The following exception was raised : {0}",
e.get_Message());
}
} //main
} //MyEventExample
- ReflectionPermission para reflejar objetos no públicos. Enumeración asociada: ReflectionPermissionFlag.TypeInformation
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
