Type.GetEvent Methode

Definition

Ruft ein bestimmtes Ereignis ab, das vom aktuellen Type deklariert oder geerbt wurde.

Überlädt

GetEvent(String, BindingFlags)

Gibt beim Überschreiben in einer abgeleiteten Klasse das EventInfo-Objekt zurück, das das angegebene Ereignis unter Verwendung der angegebenen Bindungseinschränkungen darstellt.

GetEvent(String)

Gibt das EventInfo-Objekt zurück, das das angegebene öffentliche Ereignis darstellt.

GetEvent(String, BindingFlags)

Gibt beim Überschreiben in einer abgeleiteten Klasse das EventInfo-Objekt zurück, das das angegebene Ereignis unter Verwendung der angegebenen Bindungseinschränkungen darstellt.

public:
 abstract System::Reflection::EventInfo ^ GetEvent(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
public abstract System.Reflection.EventInfo? GetEvent (string name, System.Reflection.BindingFlags bindingAttr);
public abstract System.Reflection.EventInfo GetEvent (string name, System.Reflection.BindingFlags bindingAttr);
abstract member GetEvent : string * System.Reflection.BindingFlags -> System.Reflection.EventInfo
Public MustOverride Function GetEvent (name As String, bindingAttr As BindingFlags) As EventInfo

Parameter

name
String

Die Zeichenfolge, die den Namen eines vom aktuellen Type deklarierten oder geerbten Ereignisses enthält.

bindingAttr
BindingFlags

Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird.

- oder - Default, damit null zurückgegeben wird.

Gibt zurück

EventInfo

Das Objekt, das das angegebene vom aktuellen Type deklarierte oder geerbte Ereignis darstellt, sofern gefunden, andernfalls null.

Implementiert

Ausnahmen

name ist null.

Beispiele

Im folgenden Codebeispiel wird die -Methode verwendet, um einen Typ nach einem öffentlichen oder nicht öffentlichen Ereignis namens "Click" zu durchsuchen, das nicht GetEvent(String, BindingFlags) static ist ( in Shared Visual Basic).

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

using namespace System;
using namespace System::Reflection;
using namespace System::Security;
using namespace System::Windows::Forms;

int main()
{
   try
   {
      // Creates a bitmask based on BindingFlags.
      BindingFlags myBindingFlags = static_cast<BindingFlags>(BindingFlags::Instance | BindingFlags::Public | BindingFlags::NonPublic);
      Type^ myTypeBindingFlags = System::Windows::Forms::Button::typeid;
      EventInfo^ myEventBindingFlags = myTypeBindingFlags->GetEvent( "Click", myBindingFlags );
      if ( myEventBindingFlags != nullptr )
      {
         Console::WriteLine( "Looking for the Click event in the Button class with the specified BindingFlags." );
         Console::WriteLine( myEventBindingFlags );
      }
      else
            Console::WriteLine( "The Click event is not available with the Button class." );
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The following exception was raised : {0}", e->Message );
   }
}
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);
        }
    }
}
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

Hinweise

Die folgenden BindingFlags Filterflags können verwendet werden, um zu definieren, welche Ereignisse in die Suche enthalten sein sollen:

  • Sie müssen entweder oder BindingFlags.Instance BindingFlags.Static angeben, um eine Rückgabe zu erhalten.

  • Geben BindingFlags.Public Sie an, dass öffentliche Ereignisse in die Suche enthalten sein soll.

  • Geben Sie an, dass nicht öffentliche Ereignisse (d. h. private, interne und BindingFlags.NonPublic geschützte Ereignisse) in die Suche enthalten sind.

  • Geben BindingFlags.FlattenHierarchy Sie an, public dass und statische Elemente in die Hierarchie eingeschlossen werden protected sollen. private Statische Elemente in geerbten Klassen sind nicht enthalten.

Die folgenden BindingFlags Modifiziererflags können verwendet werden, um die Funktionsweise der Suche zu ändern:

  • BindingFlags.IgnoreCase , um den Fall von zu name ignorieren.

  • BindingFlags.DeclaredOnly , um nur die Ereignisse zu durchsuchen, die auf dem Type deklariert sind, nicht ereignisse, die einfach geerbt wurden.

Weitere Informationen finden Sie unter System.Reflection.BindingFlags.

Ein Ereignis wird für reflektionsweise als öffentlich betrachtet, wenn es über mindestens eine methode oder einen öffentlichen Accessor verfügt. Andernfalls wird das Ereignis als privat betrachtet, und Sie müssen | | verwenden (in Visual Basic die Werte mithilfe von kombinieren), um es BindingFlags.NonPublic BindingFlags.Instance zu BindingFlags.Static Or erhalten.

Wenn der aktuelle einen konstruierten generischen Typ darstellt, gibt diese Methode die zurück, bei der die Typparameter durch die Type EventInfo entsprechenden Typargumente ersetzt wurden.

Wenn der aktuelle einen Typparameter in der Definition eines generischen Typs oder einer generischen Methode darstellt, durchsucht diese Methode die Ereignisse Type der Klasseneinschränkung.

Siehe auch

Gilt für

GetEvent(String)

Gibt das EventInfo-Objekt zurück, das das angegebene öffentliche Ereignis darstellt.

public:
 System::Reflection::EventInfo ^ GetEvent(System::String ^ name);
public:
 virtual System::Reflection::EventInfo ^ GetEvent(System::String ^ name);
public System.Reflection.EventInfo? GetEvent (string name);
public System.Reflection.EventInfo GetEvent (string name);
member this.GetEvent : string -> System.Reflection.EventInfo
abstract member GetEvent : string -> System.Reflection.EventInfo
override this.GetEvent : string -> System.Reflection.EventInfo
Public Function GetEvent (name As String) As EventInfo

Parameter

name
String

Die Zeichenfolge, die den Namen eines vom aktuellen Type deklarierten oder geerbten Ereignisses enthält.

Gibt zurück

EventInfo

Das Objekt, das das angegebene, vom aktuellen Type deklarierte oder geerbte öffentliche Ereignis darstellt, sofern gefunden, andernfalls null.

Implementiert

Ausnahmen

name ist null.

Beispiele

Im folgenden Beispiel wird ein EventInfo -Objekt erstellt und das -Ereignis für eine Schaltflächenklasse für das angegebene Ereignis ruft.

#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;
      EventInfo^ myEvent = myType->GetEvent( "Click" );
      if ( myEvent != nullptr )
      {
         Console::WriteLine( "Looking for the Click event in the Button class." );
         Console::WriteLine( myEvent );
      }
      else
            Console::WriteLine( "The Click event is not available in the Button class." );
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The following exception was raised : {0}", e->Message );
   }
}
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);
        }
    }
}
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

Hinweise

Ein Ereignis wird für reflektionsweise als öffentlich betrachtet, wenn es über mindestens eine methode oder einen öffentlichen Accessor verfügt. Andernfalls wird das Ereignis als privat betrachtet, und Sie müssen | | verwenden (in Visual Basic die Werte mithilfe von kombinieren), um es BindingFlags.NonPublic BindingFlags.Instance zu BindingFlags.Static Or erhalten.

Bei der Suche nach name wird die Kleinschreibung beachtet. Die Suche umfasst ereignisse für öffentliche statische und öffentliche Instanzen.

Die folgende Tabelle zeigt, welche Member einer Basisklasse von den Methoden zurückgegeben Get werden, wenn sie einen Typ reflektieren.

Memberart statischen Nicht statisch
Konstruktor Nein Nein
Feld Nein Ja. Ein Feld wird immer nach Name und Signatur ausblendet.
Ereignis Nicht zutreffend Die allgemeine Typsystemregel ist, dass die Vererbung mit der Vererbung der Methoden identisch ist, die die -Eigenschaft implementieren. Reflektion behandelt Eigenschaften als "Hide-by-name-and-signature". Siehe Hinweis 2 weiter unten.
Methode Nein Ja. Eine Methode (sowohl virtuell als auch nicht virtuell) kann nach Name oder Nach Name und Signatur ausblenden sein.
Geschachtelter Typ Nein Nein
Eigenschaft Nicht zutreffend Die allgemeine Typsystemregel ist, dass die Vererbung mit der Vererbung der Methoden identisch ist, die die -Eigenschaft implementieren. Reflektion behandelt Eigenschaften als "Hide-by-name-and-signature". Siehe Hinweis 2 weiter unten.
  1. Hide-by-name-and-signature berücksichtigt alle Teile der Signatur, einschließlich benutzerdefinierter Modifizierer, Rückgabetypen, Parametertypen, Sentinels und nicht verwalteter Aufrufkonventionen. Dies ist ein binärer Vergleich.

  2. Für Reflektion werden Eigenschaften und Ereignisse nach Name und Signatur ausblendet. Wenn Sie über eine Eigenschaft mit einem get- und einem set-Accessor in der Basisklasse verfügen, die abgeleitete Klasse jedoch nur über einen get-Accessor verfügt, blendet die abgeleitete Klasseneigenschaft die Basisklasseneigenschaft aus, und Sie können nicht auf den Setter in der Basisklasse zugreifen.

  3. Benutzerdefinierte Attribute sind nicht Teil des allgemeinen Typsystems.

Wenn der aktuelle einen konstruierten generischen Typ darstellt, gibt diese Methode die zurück, bei der die Typparameter durch die Type EventInfo entsprechenden Typargumente ersetzt wurden.

Wenn der aktuelle einen Typparameter in der Definition eines generischen Typs oder einer generischen Methode darstellt, durchsucht diese Methode die Ereignisse Type der Klasseneinschränkung.

Siehe auch

Gilt für