Type.GetEvent Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Získá konkrétní událost deklarovanou nebo zděděnou aktuální Type.

Přetížení

Name	Description
GetEvent(String, BindingFlags)	Při přepsání v odvozené třídě vrátí EventInfo objekt představující zadanou událost pomocí zadaných omezení vazby.
GetEvent(String)	EventInfo Vrátí objekt představující zadanou veřejnou událost.

GetEvent(String, BindingFlags)

Zdroj:

Type.cs

Při přepsání v odvozené třídě vrátí EventInfo objekt představující zadanou událost pomocí zadaných omezení vazby.

public:
 abstract System::Reflection::EventInfo ^ GetEvent(System::String ^ name, System::Reflection::BindingFlags bindingAttr);

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents)]
public abstract System.Reflection.EventInfo? GetEvent(string name, System.Reflection.BindingFlags bindingAttr);

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents)>]
abstract member GetEvent : string * System.Reflection.BindingFlags -> System.Reflection.EventInfo

Public MustOverride Function GetEvent (name As String, bindingAttr As BindingFlags) As EventInfo

Parametry

name

String

Název události, která je deklarována nebo zděděna aktuálním Type.

bindingAttr

BindingFlags

Bitové kombinace hodnot výčtu, které určují způsob provedení hledání.

nebo

Default nullvrátit .

Návraty

EventInfo

Objekt představující zadanou událost, která je deklarována nebo zděděna aktuální Type, je-li nalezena; jinak , null.

Atributy

DynamicallyAccessedMembersAttribute

Výjimky

ArgumentNullException

name je null.

Příklady

Následující příklad kódu používá metodu GetEvent(String, BindingFlags) k vyhledání typu veřejné nebo neveřejné události s názvem "Click", která není static (Shared v Visual Basic).

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

class MyEventExample
{
    public static void Main()
    {
        try
        {

            // Creates a bitmask based on BindingFlags.
            BindingFlags myBindingFlags = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic;
            Type myTypeBindingFlags = typeof(System.Windows.Forms.Button);
            EventInfo myEventBindingFlags = myTypeBindingFlags.GetEvent("Click", myBindingFlags);
            if(myEventBindingFlags != null)
            {
                Console.WriteLine("Looking for the Click event in the Button class with the specified BindingFlags.");
                Console.WriteLine(myEventBindingFlags.ToString());
            }
            else
            {
                Console.WriteLine("The Click event is not available with 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);
        }
    }
}

open System
open System.Reflection
open System.Security

try
    // Creates a bitmask based on BindingFlags.
    let myBindingFlags = BindingFlags.Instance ||| BindingFlags.Public ||| BindingFlags.NonPublic
    let myTypeBindingFlags = typeof<System.Windows.Forms.Button>
    let myEventBindingFlags = myTypeBindingFlags.GetEvent("Click", myBindingFlags)
    if myEventBindingFlags <> null then
        printfn $"Looking for the Click event in the Button class with the specified BindingFlags.\n{myEventBindingFlags}"
    else
        printfn "The Click event is not available with the Button class."
with
| :? SecurityException as e ->
    printfn "An exception occurred."
    printfn $"Message :{e.Message}"
| :? ArgumentNullException as e ->
    printfn "An exception occurred."
    printfn $"Message :{e.Message}"
| e ->
    printfn $"The following exception was raised : {e.Message}"

Imports System.Reflection
Imports System.Security

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

Class MyEventExample
    Public Shared Sub Main()
        Try
            ' Creates a bitmask comprising  BindingFlags.
            Dim myBindingFlags As BindingFlags = BindingFlags.Instance Or BindingFlags.Public _
                                                 Or BindingFlags.NonPublic
            Dim myTypeBindingFlags As Type = GetType(System.Windows.Forms.Button)
            Dim myEventBindingFlags As EventInfo = myTypeBindingFlags.GetEvent("Click", myBindingFlags)
            If myEventBindingFlags IsNot Nothing Then
                Console.WriteLine("Looking for the Click event in the Button class with the specified BindingFlags.")
                Console.WriteLine(myEventBindingFlags.ToString())
            Else
                Console.WriteLine("The Click event is not available with the Button class.")
            End If
        Catch e As SecurityException
            Console.WriteLine("An exception occurred.")
            Console.WriteLine("Message :" + e.Message)
        Catch e As ArgumentNullException
            Console.WriteLine("An exception occurred.")
            Console.WriteLine("Message :" + e.Message)
        Catch e As Exception
            Console.WriteLine("The following exception was raised : {0}", e.Message)
        End Try
    End Sub
End Class

Poznámky

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).

• 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.IgnoreCase ignorovat případ name.

• 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 s parametry typu nahrazené odpovídající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
• String
• BindingFlags
• DefaultBinder
• GetEvents()

GetEvent(String)

Zdroj:

Type.cs

EventInfo Vrátí objekt představující zadanou veřejnou událost.

public:
 System::Reflection::EventInfo ^ GetEvent(System::String ^ name);

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents)]
public System.Reflection.EventInfo? GetEvent(string name);

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents)>]
member this.GetEvent : string -> System.Reflection.EventInfo

Public Function GetEvent (name As String) As EventInfo

Parametry

name

String

Řetězec obsahující název události, která je deklarována nebo zděděna aktuálním Type.

Návraty

EventInfo

Objekt představující zadanou veřejnou událost, která je deklarována nebo zděděna aktuálním Type, pokud je nalezena; jinak , null.

Atributy

DynamicallyAccessedMembersAttribute

Výjimky

ArgumentNullException

name je null.

Příklady

Následující příklad vytvoří EventInfo objekt a získá událost třídy tlačítka pro zadanou událost.

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);
        }
    }
}

open System
open System.Security

try
    let myType = typeof<System.Windows.Forms.Button>
    let myEvent = myType.GetEvent "Click"
    if myEvent <> null then
        printfn $"Looking for the Click event in the Button class.\n{myEvent}"
    else
        printfn "The Click event is not available in the Button class."
with
| :? SecurityException as e ->
    printfn "An exception occurred."
    printfn $"Message :{e.Message}"
| :? ArgumentNullException as e ->
    printfn "An exception occurred."
    printfn $"Message :{e.Message}"
| e ->
    printfn $"The following exception was raised : {e.Message}"

Imports System.Reflection
Imports System.Security

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

Class MyEventExample
    Public Shared Sub Main()
        Try
            Dim myType As Type = GetType(System.Windows.Forms.Button)
            Dim myEvent As EventInfo = myType.GetEvent("Click")
            If Not (myEvent Is Nothing) Then
                Console.WriteLine(ControlChars.Cr + "Looking for the Click event in the Button class.")
                Console.WriteLine(ControlChars.Cr + myEvent.ToString())
            Else
                Console.WriteLine("The Click event is not available with the Button class.")
            End If
        Catch e As SecurityException
            Console.WriteLine("An exception occurred.")
            Console.WriteLine("Message :" + e.Message)
        Catch e As ArgumentNullException
            Console.WriteLine("An exception occurred.")
            Console.WriteLine("Message :" + e.Message)
        Catch e As Exception
            Console.WriteLine("The following exception was raised : {0}", 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).

Hledání pro name rozlišuje malá a velká písmena. Hledání zahrnuje veřejné statické a veřejné události instance.

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 s parametry typu nahrazené odpovídající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
• String
• DefaultBinder
• GetEvents()