Type.GetEvents Metoda

Definice

Získá události, které jsou deklarovány nebo zděděny aktuální Type.

Přetížení

GetEvents()

Vrátí všechny veřejné události, které jsou deklarovány nebo zděděny aktuálním Typeobjektem .

GetEvents(BindingFlags)

Při přepsání v odvozené třídě vyhledá události, které jsou deklarovány nebo zděděny aktuální Type, pomocí zadaných vazeb omezení.

GetEvents()

Zdroj:
Type.cs
Zdroj:
Type.cs
Zdroj:
Type.cs

Vrátí všechny veřejné události, které jsou deklarovány nebo zděděny aktuálním Typeobjektem .

public:
 virtual cli::array <System::Reflection::EventInfo ^> ^ GetEvents();
public virtual System.Reflection.EventInfo[] GetEvents ();
abstract member GetEvents : unit -> System.Reflection.EventInfo[]
override this.GetEvents : unit -> System.Reflection.EventInfo[]
Public Overridable Function GetEvents () As EventInfo()

Návraty

Pole EventInfo objektů představující všechny veřejné události, které jsou deklarovány nebo zděděny aktuálním Typeobjektem .

-nebo-

Prázdné pole typu EventInfo, pokud aktuální Type nemá veřejné události.

Implementuje

Příklady

Následující příklad získá pole EventInfo objektů, získá všechny události pro Button třídu a zobrazí názvy událostí. Pokud chcete zkompilovat příklad jazyka Visual Basic, použijte následující příkazový řádek:

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

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Reflection;
using namespace System::Security;

int main()
{
   try
   {
      Type^ myType = System::Windows::Forms::Button::typeid;
      array<EventInfo^>^myEvents = myType->GetEvents();
      Console::WriteLine( "The events on the Button class are: " );
      for ( int index = 0; index < myEvents->Length; index++ )
      {
         Console::WriteLine( myEvents[ index ] );

      }
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "SecurityException: {0}", e->Message );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException: {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }
}
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);
        }
    }
}
open System
open System.Reflection
open System.Security

try
    // Creates a bitmask based on BindingFlags.
    let myBindingFlags = BindingFlags.Instance ||| BindingFlags.Public
    let myTypeEvent = typeof<System.Windows.Forms.Button>
    let myEventsBindingFlags = myTypeEvent.GetEvents myBindingFlags
    printfn "\nThe events on the Button class with the specified BindingFlags are : "
    for flag in myEventsBindingFlags do
        printfn $"{flag}"
with
| :? SecurityException as e ->
    printfn $"SecurityException: {e.Message}"
| :? ArgumentNullException as e ->
    printfn $"ArgumentNullException: {e.Message}"
| e ->
    printfn $"Exception : {e.Message}"
Imports System.Reflection
Imports System.Security

' Compile this sample using the following command line:
' vbc type_getevents.vb /r:"System.Windows.Forms.dll" /r:"System.dll"

Class EventsSample

    Public Shared Sub Main()
        Try
            ' Creates a bitmask based on BindingFlags.
            Dim myBindingFlags As BindingFlags = BindingFlags.Instance Or BindingFlags.Public
            Dim myTypeEvent As Type = GetType(System.Windows.Forms.Button)
            Dim myEventsBindingFlags As EventInfo() = myTypeEvent.GetEvents(myBindingFlags)
            Console.WriteLine(ControlChars.Cr + "The events on the Button class with the specified BindingFlags are : ")
            Dim index As Integer
            For index = 0 To myEventsBindingFlags.Length - 1
                Console.WriteLine(myEventsBindingFlags(index).ToString())
            Next index
        Catch e As SecurityException
            Console.WriteLine(("SecurityException :" + e.Message))
        Catch e As ArgumentNullException
            Console.WriteLine(("ArgumentNullException : " + e.Message))
        Catch e As Exception
            Console.WriteLine(("Exception : " + e.Message))
        End Try
    End Sub
End Class

Poznámky

Událost je považována za veřejnou pro reflexi, pokud má alespoň jednu veřejnou metodu nebo přístupovou metodu. V opačném případě je událost považována za soukromou a k jejímu získání musíte použít BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static (v jazyce Visual Basic zkombinujte hodnoty pomocí ).Or

V .NET 6 a starších verzích GetEvents metoda nevrací události v určitém pořadí, jako je abecední pořadí nebo pořadí deklarací. Váš kód nesmí záviset na pořadí, ve kterém jsou události vráceny, protože toto pořadí se liší. Od verze .NET 7 je však řazení deterministické na základě pořadí metadat v sestavení.

Tato metoda může být přepsána odvozenou třídou.

Následující tabulka ukazuje, jaké členy základní třídy jsou vráceny metodami Get při odrazu na typu.

Typ členu Static Nestatický
Konstruktor No No
Pole No Yes. Pole je vždy skrýváno podle názvu a podpisu.
Událost Neuvedeno Pro systém typů platí obecné pravidlo, že dědičnost je stejná jako u metod, které implementují vlastnost. Reflexe pracuje s třídami jako se skrývanými podle názvu a podpisu. Viz poznámka 2 níže.
Metoda No Yes. Metody (virtuální i nevirtuální) mohou být skrývány podle názvu nebo podle názvu a podpisu.
Vnořený typ No No
Vlastnost Neuvedeno Pro systém typů platí obecné pravidlo, že dědičnost je stejná jako u metod, které implementují vlastnost. Reflexe pracuje s třídami jako se skrývanými podle názvu a podpisu. Viz poznámka 2 níže.
  1. Skrývání podle názvu a podpisu bere v úvahu všechny části podpisu včetně vlastních modifikátorů, návratových typů, typů parametrů, sentinelů a nespravovaných konvencí volání. Jedná se o binární porovnání.

  2. Pro účely reflexe jsou vlastnosti a události skrývány podle názvu a podpisu. Má-li vlastnost v základní třídě přístupové metody get i set, ale odvozená třída má pouze přístupovou metodu get, vlastnost odvozené třídy skryje vlastnost základní třídy a nebudete mít k dispozici přístup k metodě set základní třídy.

  3. Vlastní atributy nejsou součástí systému společných typů.

Pokud proud Type představuje konstruovaný obecný typ, vrátí EventInfo tato metoda objekty s parametry typu nahrazené odpovídajícími argumenty typu.

Pokud current Type představuje parametr typu v definici obecného typu nebo obecné metody, tato metoda prohledá události omezení třídy.

Viz také

Platí pro

GetEvents(BindingFlags)

Zdroj:
Type.cs
Zdroj:
Type.cs
Zdroj:
Type.cs

Při přepsání v odvozené třídě vyhledá události, které jsou deklarovány nebo zděděny aktuální Type, pomocí zadaných vazeb omezení.

public:
 abstract cli::array <System::Reflection::EventInfo ^> ^ GetEvents(System::Reflection::BindingFlags bindingAttr);
public abstract System.Reflection.EventInfo[] GetEvents (System.Reflection.BindingFlags bindingAttr);
abstract member GetEvents : System.Reflection.BindingFlags -> System.Reflection.EventInfo[]
Public MustOverride Function GetEvents (bindingAttr As BindingFlags) As EventInfo()

Parametry

bindingAttr
BindingFlags

Bitové kombinace hodnot výčtu, které určují, jak se provádí hledání.

-nebo-

Default a vrátí prázdné pole.

Návraty

Pole EventInfo objektů představující všechny události, které jsou deklarovány nebo zděděny proudem Type , který odpovídá zadaným omezením vazby.

-nebo-

Prázdné pole typu EventInfo, pokud aktuální Type neobsahuje události nebo pokud žádná z událostí neodpovídá omezením vazby.

Implementuje

Příklady

Následující příklad získá pole EventInfo objektů, které odpovídají zadaným příznakům vazby, získá všechny události pro Button třídu a zobrazí názvy událostí. Pokud chcete zkompilovat příklad jazyka Visual Basic, použijte následující příkazový řádek:

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

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Reflection;
using namespace System::Security;

int main()
{
   try
   {
      
      // Create a bitmask based on BindingFlags.
      BindingFlags myBindingFlags = static_cast<BindingFlags>(BindingFlags::Instance | BindingFlags::Public);
      Type^ myTypeEvent = System::Windows::Forms::Button::typeid;
      array<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 ] );

      }
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "SecurityException: {0}", e->Message );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException: {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }
}
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);
        }
    }
}
open System
open System.Reflection
open System.Security

try
    // Creates a bitmask based on BindingFlags.
    let myBindingFlags = BindingFlags.Instance ||| BindingFlags.Public
    let myTypeEvent = typeof<System.Windows.Forms.Button>
    let myEventsBindingFlags = myTypeEvent.GetEvents myBindingFlags
    printfn "\nThe events on the Button class with the specified BindingFlags are : "
    for flag in myEventsBindingFlags do
        printfn $"{flag}"
with
| :? SecurityException as e ->
    printfn $"SecurityException: {e.Message}"
| :? ArgumentNullException as e ->
    printfn $"ArgumentNullException: {e.Message}"
| e ->
    printfn $"Exception : {e.Message}"
Imports System.Reflection
Imports System.Security
Imports System.Windows.Forms

Class EventsSample

    Public Shared Sub Main()
        Try
            ' Create a bitmask based on BindingFlags.
            Dim myBindingFlags As BindingFlags = BindingFlags.Instance Or BindingFlags.Public
            Dim myTypeEvent As Type = GetType(System.Windows.Forms.Button)
            Dim myEventsBindingFlags As EventInfo() = myTypeEvent.GetEvents(myBindingFlags)
            Console.WriteLine(ControlChars.Cr + "The events on the Button class with the specified BindingFlags are:")
            Dim index As Integer
            For index = 0 To myEventsBindingFlags.Length - 1
                Console.WriteLine(myEventsBindingFlags(index).ToString())
            Next index
        Catch e As SecurityException
            Console.WriteLine("SecurityException:" + e.Message)
        Catch e As ArgumentNullException
            Console.WriteLine("ArgumentNullException: " + e.Message)
        Catch e As Exception
            Console.WriteLine("Exception: " + e.Message)
        End Try
    End Sub
End Class

Poznámky

V .NET 6 a starších verzích GetEvents metoda nevrací události v určitém pořadí, jako je abecední pořadí nebo pořadí deklarací. Váš kód nesmí záviset na pořadí, ve kterém jsou události vráceny, protože toto pořadí se liší. Od verze .NET 7 je však řazení deterministické na základě pořadí metadat v sestavení.

BindingFlags Následující příznaky filtru lze použít k definování událostí, které se mají zahrnout do hledání:

  • Pokud chcete získat vrácení, musíte zadat buď BindingFlags.Instance nebo BindingFlags.Static .

  • Zadejte BindingFlags.Public , aby se do hledání zahrnuly veřejné události.

  • Zadejte BindingFlags.NonPublic , aby se do hledání zahrnuly neveřejné události (tj. soukromé, interní a chráněné události). Jsou vráceny pouze chráněné a interní události v základních třídách; privátní události v základních třídách se nevrátí.

  • Zadejte BindingFlags.FlattenHierarchy zahrnutí public a protected statické členy v hierarchii; private statické členy ve zděděných třídách nejsou zahrnuty.

Pomocí následujících BindingFlags modifikačních příznaků můžete změnit fungování vyhledávání:

  • BindingFlags.DeclaredOnly prohledat pouze události deklarované na Type, nikoli události, které byly jednoduše zděděny.

Další informace naleznete v tématu System.Reflection.BindingFlags.

Událost je považována za veřejnou pro reflexi, pokud má alespoň jednu veřejnou metodu nebo přístupovou metodu. V opačném případě je událost považována za soukromou a k jejímu získání musíte použít BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static (v jazyce Visual Basic zkombinujte hodnoty pomocí ).Or

Pokud proud Type představuje konstruovaný obecný typ, vrátí EventInfo tato metoda objekty s parametry typu nahrazené odpovídajícími argumenty typu.

Pokud current Type představuje parametr typu v definici obecného typu nebo obecné metody, tato metoda prohledá události omezení třídy.

Viz také

Platí pro