Type.GetEvents Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Obtém os eventos que são declarados ou herdados pelo Type atual.

Sobrecargas

GetEvents()	Retorna todos os eventos públicos que são declarados ou herdados pelo Type atual.
GetEvents(BindingFlags)	Quando substituído em uma classe derivada, procura por eventos que são declarados ou herdados pelo Type atual, usando as restrições de associação especificadas.

GetEvents()

Origem:

Type.cs

Retorna todos os eventos públicos que são declarados ou herdados pelo Type atual.

C#

public virtual System.Reflection.EventInfo[] GetEvents();

Retornos

EventInfo[]

Uma matriz de objetos EventInfo que representam todos os eventos públicos que são declarados ou herdados pelo Type atual.

- ou -

Uma matriz vazia do tipo EventInfo, se o Type atual não tiver eventos públicos.

Exemplos

O exemplo a seguir obtém uma matriz de EventInfo objetos, obtém todos os eventos de uma Button classe e exibe os nomes dos eventos. Para compilar o exemplo do Visual Basic, use a seguinte linha de comando:

vbc type_getevents1.vb /r:System.Windows.Forms.dll /r:System.dll

C#

using System;
using System.Reflection;
using System.Security;

class EventsSample
{
    public static void Main()
    {
        try
        {
            // Creates a bitmask based on BindingFlags.
            BindingFlags myBindingFlags = BindingFlags.Instance | BindingFlags.Public;
            Type myTypeEvent = typeof(System.Windows.Forms.Button);
            EventInfo[] myEventsBindingFlags = myTypeEvent.GetEvents(myBindingFlags);
            Console.WriteLine("\nThe events on the Button class with the specified BindingFlags are : ");
            for (int index = 0; index < myEventsBindingFlags.Length; index++)
            {
                Console.WriteLine(myEventsBindingFlags[index].ToString());
            }
        }
        catch(SecurityException e)
        {
            Console.WriteLine("SecurityException :" + e.Message);
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException : " + e.Message);
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception : " + e.Message);
        }
    }
}

Comentários

Um evento é considerado público para reflexão caso tenha pelo menos um método ou um acessador público. Caso contrário, o evento será considerado privado e você deverá usar BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static (no Visual Basic, combinar os valores usando Or) para obtê-lo.

No .NET 6 e em versões anteriores, o GetEvents método não retorna eventos em uma ordem específica, como ordem alfabética ou de declaração. Seu código não deve depender da ordem em que os eventos são retornados, pois essa ordem varia. No entanto, a partir do .NET 7, a ordenação é determinística com base na ordenação de metadados no assembly.

Este método pode ser substituído por uma classe derivada.

A tabela a seguir mostra quais membros de uma classe base são retornados pelos métodos Get durante a reflexão em um tipo.

Tipo do membro	Estático	Não estático
Construtor	Não	Não
Campo	Não	Sim. Um campo permanece sempre oculto por nome e assinatura.
Evento	Não aplicável	A regra de sistema do tipo comum é que a herança é a mesma dos métodos que implementam a propriedade. Reflexão trata propriedades como ocultas por nome e assinatura. Consulte a observação 2 abaixo.
Método	Não	Sim. Um método (virtual e não virtual) pode permanecer oculto por nome ou por nome e assinatura.
Tipo aninhado	Não	Não
Propriedade	Não aplicável	A regra de sistema do tipo comum é que a herança é a mesma dos métodos que implementam a propriedade. Reflexão trata propriedades como ocultas por nome e assinatura. Consulte a observação 2 abaixo.

1. Oculto por nome e assinatura considera todas as partes da assinatura, inclusive modificadores personalizados, tipos de retorno, tipos de parâmetro, sentinelas e convenções de chamada não gerenciadas. Esta é uma comparação binária.

2. Para reflexão, propriedades e eventos permanecem ocultos por nome e assinatura. Se você tiver uma propriedade com um acessador get e set na classe base, mas a classe derivada tiver apenas um acessador get, a propriedade de classe derivada ocultará a propriedade da classe base e você não poderá acessar o setter na classe base.

3. Atributos personalizados não fazem parte do sistema de tipo comum.

Se o atual Type representar um tipo genérico construído, esse método retornará os EventInfo objetos com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou um método genérico, este método pesquisa os eventos da restrição de classe.

Confira também

• EventInfo
• GetEvent(String)

GetEvents(BindingFlags)

Origem:

Type.cs

Quando substituído em uma classe derivada, procura por eventos que são declarados ou herdados pelo Type atual, usando as restrições de associação especificadas.

C#

public abstract System.Reflection.EventInfo[] GetEvents(System.Reflection.BindingFlags bindingAttr);

Parâmetros

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é realizada.

- ou -

Default para retornar uma matriz vazia.

Retornos

EventInfo[]

Uma matriz de objetos EventInfo que representam todos os eventos que são declarados ou herdados pelo Type atual, que corresponde às restrições de associação especificadas.

- ou -

Uma matriz vazia do tipo EventInfo, se o Type atual não tiver eventos ou se nenhum dos eventos corresponderem às restrições de associação.

Exemplos

O exemplo a seguir obtém uma matriz de objetos que correspondem aos sinalizadores de EventInfo associação especificados, obtém todos os eventos de uma Button classe e exibe os nomes dos eventos. Para compilar o exemplo do Visual Basic, use a seguinte linha de comando:

vbc type_getevents2.vb /r:System.Windows.Forms.dll /r:System.dll

C#

using System;
using System.Reflection;
using System.Security;

class EventsSample
{
    public static void Main()
    {
        try
        {
            // Create a bitmask based on BindingFlags.
            BindingFlags myBindingFlags = BindingFlags.Instance | BindingFlags.Public;
            Type myTypeEvent = typeof(System.Windows.Forms.Button);
            EventInfo[] myEventsBindingFlags = myTypeEvent.GetEvents(myBindingFlags);
            Console.WriteLine("\nThe events on the Button class with the specified BindingFlags are:");
            for (int index = 0; index < myEventsBindingFlags.Length; index++)
            {
                Console.WriteLine(myEventsBindingFlags[index].ToString());
            }
        }
        catch(SecurityException e)
        {
            Console.WriteLine("SecurityException:" + e.Message);
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException: " + e.Message);
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception: " + e.Message);
        }
    }
}

Comentários

No .NET 6 e em versões anteriores, o GetEvents método não retorna eventos em uma ordem específica, como ordem alfabética ou de declaração. Seu código não deve depender da ordem em que os eventos são retornados, pois essa ordem varia. No entanto, a partir do .NET 7, a ordenação é determinística com base na ordenação de metadados no assembly.

Os seguintes BindingFlags sinalizadores de filtro podem ser usados para definir quais eventos incluir na pesquisa:

• Você deve especificar BindingFlags.Instance ou BindingFlags.Static para obter um retorno.

• Especifique BindingFlags.Public para incluir eventos públicos na pesquisa.

• Especifique BindingFlags.NonPublic para incluir eventos não públicos (ou seja, eventos privados, internos e protegidos) na pesquisa. Somente eventos protegidos e internos em classes base são retornados; eventos privados em classes base não são retornados.

• Especifique BindingFlags.FlattenHierarchy para incluir os membros estáticos public e protected acima na hierarquia; os membros estáticos private em classes herdadas não são incluídos.

Os seguintes sinalizadores de modificador BindingFlags podem ser usados para alterar como a pesquisa funciona:

• BindingFlags.DeclaredOnly para pesquisar apenas os eventos declarados no Type, não eventos que foram simplesmente herdados.

Consulte System.Reflection.BindingFlags para obter mais informações.

Um evento é considerado público para reflexão caso tenha pelo menos um método ou um acessador público. Caso contrário, o evento será considerado privado e você deverá usar BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static (no Visual Basic, combinar os valores usando Or) para obtê-lo.

Se o atual Type representar um tipo genérico construído, esse método retornará os EventInfo objetos com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou um método genérico, este método pesquisa os eventos da restrição de classe.

Confira também

• EventInfo
• BindingFlags
• DefaultBinder
• GetEvent(String)