Type.GetEvents Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Získá události deklarované nebo zděděné aktuálním Type.

Přetížení

Name	Description
GetEvents()	Vrátí všechny veřejné události, které jsou deklarovány nebo zděděné aktuálním Type.
GetEvents(BindingFlags)	Při přepsání v odvozené třídě vyhledá události, které jsou deklarovány nebo zděděné aktuálním Type, pomocí zadaných omezení vazby.

GetEvents()

Zdroj:

Type.cs

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

public:
 virtual cli::array <System::Reflection::EventInfo ^> ^ GetEvents();

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents)]
public virtual System.Reflection.EventInfo[] GetEvents();

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents)>]
abstract member GetEvents : unit -> System.Reflection.EventInfo[]
override this.GetEvents : unit -> System.Reflection.EventInfo[]

Public Overridable Function GetEvents () As EventInfo()

Návraty

EventInfo[]

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

nebo

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

Atributy

DynamicallyAccessedMembersAttribute

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í. Ke kompilaci Visual Basic příkladu použijte následující příkazový řádek:

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

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 metodu nebo přístup, který je veřejný. Jinak je událost považována za soukromou a k získání této události je nutné použít BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (v Visual Basic zkombinovat hodnoty pomocí Or).

V .NET 6 a starších verzích metoda GetEvents 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 se události vrátí, protože se tato objednávka liší. Od .NET 7 je však řazení deterministické na základě pořadí metadat v sestavení.

Tuto metodu lze přepsat odvozenou třídou.

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

Typ členu	Static	Nestatické
Konstruktor	No	No
Pole	No	Yes. Pole se vždy skryje podle názvu a signatury.
Událost	Není relevantní	Běžné pravidlo systému typů je, že dědičnost je stejná jako u metod, které implementují vlastnost. Reflexe považuje vlastnosti za skrýt podle názvu a podpisu. Viz poznámka 2 níže.
Metoda	No	Yes. Metodu (virtuální i ne virtuální) lze skrýt podle názvu nebo skrýt podle názvu a podpisu.
Vnořený typ	No	No
Vlastnictví	Není relevantní	Běžné pravidlo systému typů je, že dědičnost je stejná jako u metod, které implementují vlastnost. Reflexe považuje vlastnosti za skrýt podle názvu a podpisu. Viz poznámka 2 níže.

1. Funkce skrytí podle jména a podpisu zohledňuje 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 reflexi jsou vlastnosti a události skryty podle názvu a podpisu. Pokud máte vlastnost s oběma přístupovými metodami get i set v základní třídě, ale odvozená třída má pouze přístupovou metodu get, odvozená třída překryje vlastnost základní třídy a nebudete mít přístup k nastavovací metodě základní třídy.

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

Pokud aktuální Type představuje vytvořený obecný typ, tato metoda vrátí EventInfo objekty s parametry typu nahrazené příslušnými argumenty typu.

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

Viz také

• EventInfo
• GetEvent(String)

GetEvents(BindingFlags)

Zdroj:

Type.cs

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

public:
 abstract cli::array <System::Reflection::EventInfo ^> ^ GetEvents(System::Reflection::BindingFlags bindingAttr);

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents)]
public abstract System.Reflection.EventInfo[] GetEvents(System.Reflection.BindingFlags bindingAttr);

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents)>]
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í způsob provedení hledání.

nebo

Default pro vrácení prázdného pole.

Návraty

EventInfo[]

Pole EventInfo objektů představujících všechny události deklarované nebo zděděné aktuálními Type omezeními vazby.

nebo

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

Atributy

DynamicallyAccessedMembersAttribute

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í. Ke kompilaci Visual Basic příkladu použijte následující příkazový řádek:

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

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 metoda GetEvents 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 se události vrátí, protože se tato objednávka liší. Od .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é mají být zahrnuty do hledání:

• Abyste získali vrácení, je nutné zadat buď BindingFlags.Instance nebo BindingFlags.Static.

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

• Zadejte BindingFlags.NonPublic , aby do vyhledávání byly zahrnuty neveřejné události (tj. soukromé, interní a chráněné události). Vrátí se pouze chráněné a interní události základních tříd; privátní události v základních třídách se nevrácejí.

• Určete BindingFlags.FlattenHierarchy, aby se zahrnuly public a protected statické členy v hierarchii; ale private statické členy v zděděných třídách nejsou zahrnuty.

Ke změně fungování vyhledávání můžete použít následující BindingFlags modifikační příznaky:

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

Další informace naleznete na System.Reflection.BindingFlags.

Událost je považována za veřejnou pro reflexi, pokud má alespoň jednu metodu nebo přístup, který je veřejný. Jinak je událost považována za soukromou a k získání této události je nutné použít BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (v Visual Basic zkombinovat hodnoty pomocí Or).

Pokud aktuální Type představuje vytvořený obecný typ, tato metoda vrátí EventInfo objekty s parametry typu nahrazené příslušnými argumenty typu.

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

Viz také

• EventInfo
• BindingFlags
• DefaultBinder
• GetEvent(String)