Type.GetEvent Yöntem

Tanım

Geçerli tarafından belirtilen veya devralınan belirli bir olayı alır Type .

Aşırı Yüklemeler

GetEvent(String, BindingFlags)

Türetilmiş bir sınıfta geçersiz kılınırsa, EventInfo belirtilen bağlama kısıtlamalarını kullanarak belirtilen olayı temsil eden nesneyi döndürür.

GetEvent(String)

EventInfoBelirtilen ortak olayı temsil eden nesneyi döndürür.

GetEvent(String, BindingFlags)

Türetilmiş bir sınıfta geçersiz kılınırsa, EventInfo belirtilen bağlama kısıtlamalarını kullanarak belirtilen olayı temsil eden nesneyi döndürür.

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

Parametreler

name
String

Geçerli tarafından belirtilen veya devralınan bir olayın adını içeren dize Type .

bindingAttr
BindingFlags

Aramanın nasıl yürütüldüğünü belirten numaralandırma değerlerinin bit düzeyinde birleşimi.

-veya- Default dönün null .

Döndürülenler

EventInfo

Bulunursa, geçerli tarafından tanımlanan veya devralınan belirtilen olayı temsil eden nesne Type ; Aksi durumda, null .

Uygulamalar

Özel durumlar

name, null değeridir.

Örnekler

Aşağıdaki kod örneği, GetEvent(String, BindingFlags) genel veya genel olmayan bir olay için bir tür aramak için yöntemini kullanır static ( 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

Açıklamalar

BindingFlagsAramaya hangi olayların ekleneceğini tanımlamak için aşağıdaki filtre bayrakları kullanılabilir:

  • BindingFlags.Instance BindingFlags.Static Dönüş almak için ya da ' i belirtmeniz gerekir.

  • BindingFlags.PublicAramaya genel olayları eklemek için belirtin.

  • BindingFlags.NonPublicAramada genel olmayan olayları (yani özel, iç ve korumalı olayları) dahil etmek için belirtin.

  • BindingFlags.FlattenHierarchyHiyerarşinin dahil edileceğini public ve protected statik üyelerini belirtin; private devralınan sınıflarda statik üyeler dahil değildir.

BindingFlagsAramanın nasıl çalıştığını değiştirmek için aşağıdaki değiştirici bayrakları kullanılabilir:

  • BindingFlags.IgnoreCase durumunu yok saymak için name .

  • BindingFlags.DeclaredOnly yalnızca içinde belirtilen olayları aramak için, yalnızca Type devralınmış olayları değil.

Daha fazla bilgi edinmek için bkz. System.Reflection.BindingFlags.

Bir olay genel özellikli en az bir yöntem veya erişimci içeriyorsa, yansıma için genel sayılır. aksi takdirde olay özel olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem EventInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının olaylarını arar.

Ayrıca bkz.

Şunlara uygulanır

GetEvent(String)

EventInfoBelirtilen ortak olayı temsil eden nesneyi döndürür.

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

Parametreler

name
String

Geçerli tarafından belirtilen veya devralınan bir olayın adını içeren dize Type .

Döndürülenler

EventInfo

Bulunursa geçerli olan veya devralınan belirtilen genel olayı temsil eden nesne Type ; Aksi durumda, null .

Uygulamalar

Özel durumlar

name, null değeridir.

Örnekler

Aşağıdaki örnek bir nesnesi oluşturur EventInfo ve belirtilen olay için bir Button sınıfının olayını alır.

#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

Açıklamalar

Bir olay genel özellikli en az bir yöntem veya erişimci içeriyorsa, yansıma için genel sayılır. aksi takdirde olay özel olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).

Arama name büyük/küçük harfe duyarlıdır. Arama, ortak statik ve ortak örnek olayları içerir.

Aşağıdaki tabloda, Get bir tür üzerinde yansıtılırken yöntemler tarafından bir temel sınıfın hangi üyelerinin döndürüldüğü gösterilmektedir.

Üye Türü Statik Statik Olmayan
Oluşturucu Hayır Hayır
Alan Hayır Evet. Bir alan her zaman "ada ve imzaya göre gizle" özelliğindedir.
Olay Uygulanamaz Ortak tür sistemi kuralı, devralma işleminin özelliği uygulayan yöntemlerinkiyle aynı olmasıdır. Yansıma, özellikleri "ada ve imzaya göre gizle" şeklinde kullanır. Aşağıdaki 2. nota bakın.
Yöntem Hayır Evet. Bir yöntem (sanal ve sanal olmayan) "ada göre gizle" veya "ada ve imzaya göre gizle" özelliğinde olabilir.
İç İçe Tür Hayır Hayır
Özellik Uygulanamaz Ortak tür sistemi kuralı, devralma işleminin özelliği uygulayan yöntemlerinkiyle aynı olmasıdır. Yansıma, özellikleri "ada ve imzaya göre gizle" şeklinde kullanır. Aşağıdaki 2. nota bakın.
  1. "Ada ve imzaya göre gizle" özelliği, imzanın tüm parçalarını (özel değiştiriciler, dönüş türleri, parametre türleri, başlangıç/bitiş simgeleri ve yönetilmeyen çağrı kuralları dahil) dikkate alır. Bu ikili bir karşılaştırmadır.

  2. Yansıma için, özellikler ve olaylar "ada ve imzaya göre gizle" özelliğindedir. Bu temel sınıfta hem alma hem de ayarlama erişimcisine sahip bir özelliğiniz varsa, ancak türetilen sınıfın yalnızca bir alma erişimcisi varsa, türetilen sınıf özelliği temel sınıf özelliğini gizler ve siz de temel sınıfta ayarlayıcıya erişemezsiniz.

  3. Özel öznitelikler ortak tür sisteminin parçası değildir.

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem EventInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının olaylarını arar.

Ayrıca bkz.

Şunlara uygulanır