Type.GetEvent Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Lekéri az aktuális Typeáltal deklarált vagy öröklődő eseményt.

Túlterhelések

Name	Description
GetEvent(String, BindingFlags)	Származtatott osztály felülírásakor a EventInfo megadott eseményt képviselő objektumot adja vissza a megadott kötési megkötések használatával.
GetEvent(String)	EventInfo A megadott nyilvános eseményt képviselő objektumot adja vissza.

GetEvent(String, BindingFlags)

Forrás:

Type.cs

Származtatott osztály felülírásakor a EventInfo megadott eseményt képviselő objektumot adja vissza a megadott kötési megkötések használatával.

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

Paraméterek

name

String

Az aktuális Typeáltal deklarált vagy örökölt esemény neve.

bindingAttr

BindingFlags

A számbavételi értékek bitenkénti kombinációja, amely meghatározza a keresés menetét.

-vagy-

Default visszatéréshez null.

Válaszok

EventInfo

A megadott eseményt képviselő objektum, amelyet az aktuális Typedeklarált vagy örököl , ha megtalálható; egyébként null.

Attribútumok

DynamicallyAccessedMembersAttribute

Kivételek

ArgumentNullException

name az null.

Példák

Az alábbi kódpéldában a GetEvent(String, BindingFlags) metódussal kereshet olyan "Click" nevű nyilvános vagy nem nyilvános eseménytípust, amely nem static (Shared 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

Megjegyzések

A következő BindingFlags szűrőjelölők segítségével határozhatja meg, hogy mely események legyenek belefoglalva a keresésbe:

• A visszatéréshez meg kell adnia vagy a BindingFlags.Instance vagy a BindingFlags.Static.

• Adja meg BindingFlags.Public , hogy nyilvános eseményeket is belefoglaljon a keresésbe.

• Adja meg BindingFlags.NonPublic , hogy nem nyilvános eseményeket (azaz privát, belső és védett eseményeket) is belefoglaljon a keresésbe.

• Adja meg a BindingFlags.FlattenHierarchy-t, hogy a hierarchiába belefoglalja a public és protected statikus tagokat; az örökölt osztályokban lévő private statikus tagok nem szerepelnek.

A keresés működésének módosításához az alábbi BindingFlags módosító jelzők használhatók:

• BindingFlags.IgnoreCase a eset figyelmen kívül hagyásához name.

• BindingFlags.DeclaredOnly csak a deklarált Typeesemények keresésére, nem pedig az egyszerűen öröklött eseményekre.

További információért lásd a System.Reflection.BindingFlags jelű részt.

Az esemény akkor tekinthető nyilvánosnak, ha legalább egy nyilvános módszerrel vagy kiegészítővel rendelkezik. Ellenkező esetben az esemény privátnak minősül, és a BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual Basic az értékeket Or) használatával kell használnia a lekéréséhez.

Ha a jelenlegi Type egy létrehozott általános típust jelöl, ez a metódus a EventInfo-t adja vissza, ahol a típusparamétereket a megfelelő típusargumentumokkal helyettesítettük.

Ha az aktuális Type érték egy típusparamétert jelöl egy általános típus vagy általános metódus definíciójában, ez a metódus megkeresi az osztálykényszer eseményeit.

Lásd még

• EventInfo
• String
• BindingFlags
• DefaultBinder
• GetEvents()

GetEvent(String)

Forrás:

Type.cs

EventInfo A megadott nyilvános eseményt képviselő objektumot adja vissza.

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

Paraméterek

name

String

Az aktuális Typeáltal deklarált vagy örökölt esemény nevét tartalmazó sztring.

Válaszok

EventInfo

A megadott nyilvános eseményt képviselő objektum, amelyet az aktuális Typedeklarált vagy örököl , ha megtalálható; egyébként null.

Attribútumok

DynamicallyAccessedMembersAttribute

Kivételek

ArgumentNullException

name az null.

Példák

Az alábbi példa létrehoz egy EventInfo objektumot, és lekéri a megadott eseményhez tartozó gombosztály eseményét.

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

Megjegyzések

Az esemény akkor tekinthető nyilvánosnak, ha legalább egy nyilvános módszerrel vagy kiegészítővel rendelkezik. Ellenkező esetben az esemény privátnak minősül, és a BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual Basic az értékeket Or) használatával kell használnia a lekéréséhez.

A keresés name érzékeli a kis- és nagybetűk közötti különbséget. A keresés nyilvános statikus és nyilvános példányeseményeket is tartalmaz.

Az alábbi táblázat azt mutatja be, hogy egy alaposztály mely tagjait adják vissza a metódusok egy Get típuson való tükrözéskor.

Tagtípus	Static	Nem statikus
Constructor	No	No
Field	No	Yes. A mezők mindig név és aláírás alapján rejthetők el.
Esemény	Nem alkalmazható	A gyakori típusrendszerszabály az, hogy az öröklés megegyezik a tulajdonságot megvalósító metódusok öröklésével. A tükröződés a tulajdonságokat név és aláírás elrejtéseként kezeli. Lásd az alábbi 2. megjegyzést.
Módszer	No	Yes. A metódusok (mind a virtuális, mind a nem virtuális) elrejthetők név szerint vagy elrejthetők név és aláírás alapján.
Beágyazott típus	No	No
Ingatlan	Nem alkalmazható	A gyakori típusrendszerszabály az, hogy az öröklés megegyezik a tulajdonságot megvalósító metódusok öröklésével. A tükröződés a tulajdonságokat név és aláírás elrejtéseként kezeli. Lásd az alábbi 2. megjegyzést.

1. A név és aláírás szerinti elrejtés az aláírás összes részét figyelembe veszi, beleértve az egyéni módosítókat, a visszatérési típusokat, a paramétertípusokat, a sentineleket és a nem kezelt hívási konvenciókat. Ez egy bináris összehasonlítás.

2. A reflexió során a tulajdonságok és események név és szignatúra szerint vannak elrejtve. Ha az alaposztálynak van egy beolvasási és egy beállítási kiegészítővel rendelkező tulajdonsága, de a származtatott osztálynak csak beolvasási kiegészítője van, a származtatott osztály tulajdonsága elrejti az alaposztály tulajdonságát, és nem tudja majd elérni a beállítót az alaposztályban.

3. Az egyéni attribútumok nem részei a gyakori típusrendszernek.

Ha a jelenlegi Type egy létrehozott általános típust jelöl, ez a metódus a EventInfo-t adja vissza, ahol a típusparamétereket a megfelelő típusargumentumokkal helyettesítettük.

Ha az aktuális Type érték egy típusparamétert jelöl egy általános típus vagy általános metódus definíciójában, ez a metódus megkeresi az osztálykényszer eseményeit.

Lásd még

• EventInfo
• String
• DefaultBinder
• GetEvents()