EventInfo Sınıf

Tanım

Ad Alanı:

System.Reflection

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

EventInfo.cs

Bir olayın özniteliklerini bulur ve olay meta verilerine erişim sağlar.

public ref class EventInfo abstract : System::Reflection::MemberInfo

public abstract class EventInfo : System.Reflection.MemberInfo

type EventInfo = class
    inherit MemberInfo

Public MustInherit Class EventInfo
Inherits MemberInfo

Devralma

Object

MemberInfo

EventInfo

Türetilmiş

System.Runtime.InteropServices.ComAwareEventInfo

Örnekler

Aşağıdaki kod, sınıfının olayı Button için Click bir EventInfo nesnesi 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;
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

yönteminin örnek kodunda EventInfo gösterildiği gibi olayları incelemek ve olay işleyicilerini bağlamak için sınıfını AddEventHandler kullanın.

Not

EventInfo , olayları tetiklerken kullanılmak üzere tasarlanmamıştır. Bir nesne, iç durumu tarafından dikte edilen olayları oluşturur.

Olaylar temsilcilerle birlikte kullanılır. Olay dinleyicisi, olay bir olay kaynağı tarafından her tetiklendiğinde çağrılan bir olay işleyicisi temsilcisinin örneğini oluşturur. Olay kaynağına bağlanmak için, olay dinleyicisi bu temsilciyi kaynaktaki çağırma listesine ekler. Olay tetiklendiğinde, olay işleyicisi temsilcisinin invoke yöntemi çağrılır. Hem çok noktaya yayın hem de tek yayınlı olay bildirimleri desteklenir. ve Remove yöntemlerinin Add yanı sıra bir olayla ilişkili olay işleyicisi temsilci sınıfı meta verilerde işaretlenmelidir.

Temsilciler nesne odaklı işlev işaretçileridir. C veya C++ dilinde işlev işaretçisi bir yöntem başvurusudur. C veya C++ işlev işaretçisinin aksine, temsilci iki başvuru içerir: bir yönteme başvuru ve yöntemi destekleyen bir nesneye başvuru. Temsilciler, yöntemi bildiren veya devralan sınıf türünü bilmeden bir yöntemi çağırabilir. Temsilcilerin yalnızca yöntemin dönüş türünü ve parametre listesini bilmesi gerekir.

Olay modeli, tek atamalı ve çok noktaya yayın temsilcileri için de aynı derecede iyi çalışır. Temsilcinin çağırma yöntemi çağrıldığında, yalnızca tek bir nesnenin üzerinde çağrılan bir yöntemi olur. Temsilci bildirimine çok noktaya yayın değiştirici uygulanabilir ve bu da temsilcinin çağırma yöntemi çağrıldığında birden çok yöntemin çağrılmasına olanak tanır.

ICustomAttributeProvider.GetCustomAttributes EventInfo parametresinin GetCustomAttributes ne zaman inherit çağrılması true tür hiyerarşisine yürümez. Özel öznitelikleri devralmak için kullanın System.Attribute .

Uygulayanlara Notlar

'den EventInfodevraldığınızda, şu üyeleri geçersiz kılmalısınız: GetAddMethod(Boolean), GetRemoveMethod(Boolean)ve GetRaiseMethod(Boolean).

Oluşturucular

EventInfo()

EventInfo sınıfının yeni bir örneğini başlatır.

Özellikler

AddMethod	MethodInfo Ortak olmayan yöntemler de dahil olmak üzere olayın yöntemi için AddEventHandler(Object, Delegate) nesnesini alır.
Attributes	Bu olayın özniteliklerini alır.
CustomAttributes	Bu üyenin özel özniteliklerini içeren bir koleksiyon alır. (Devralındığı yer: MemberInfo)
DeclaringType	Bu üyeyi bildiren sınıfı alır. (Devralındığı yer: MemberInfo)
EventHandlerType	Type Bu olayla ilişkili temel olay işleyici temsilcisinin nesnesini alır.
IsCollectible	Bu MemberInfo nesnenin bir collectible AssemblyLoadContextiçinde tutulan derlemenin parçası olup olmadığını gösteren bir değer alır. (Devralındığı yer: MemberInfo)
IsMulticast	Olayın çok noktaya yayın olup olmadığını belirten bir değer alır.
IsSpecialName	özel anlamı olan bir ada sahip olup olmadığını EventInfo belirten bir değer alır.
MemberType	Bu üyenin bir MemberTypes olay olduğunu belirten bir değer alır.
MetadataToken	Meta veri öğesini tanımlayan bir değer alır. (Devralındığı yer: MemberInfo)
Module	Geçerli MemberInfo tarafından temsil edilen üyeyi bildiren türün tanımlandığı modülü alır. (Devralındığı yer: MemberInfo)
Name	Geçerli üyenin adını alır. (Devralındığı yer: MemberInfo)
RaiseMethod	Ortak olmayan yöntemler de dahil olmak üzere olay tetiklendiğinde çağrılan yöntemi alır.
ReflectedType	bu örneğini MemberInfoalmak için kullanılan sınıf nesnesini alır. (Devralındığı yer: MemberInfo)
RemoveMethod	MethodInfo Ortak olmayan yöntemler de dahil olmak üzere olayın bir yöntemini kaldırmak için nesnesini alır.

Yöntemler

AddEventHandler(Object, Delegate)	Olay kaynağına olay işleyicisi ekler.
Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür.
GetAddMethod()	Olay kaynağına bir olay işleyici temsilcisi eklemek için kullanılan yöntemi döndürür.
GetAddMethod(Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, ortak olmayan yöntemlerin AddEventHandler(Object, Delegate) döndürülip döndürülmeyeceğini belirterek olayın yöntemi için nesnesini alırMethodInfo.
GetCustomAttributes(Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, bu üyeye uygulanan tüm özel özniteliklerden oluşan bir dizi döndürür. (Devralındığı yer: MemberInfo)
GetCustomAttributes(Type, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, bu üyeye uygulanan ve tarafından Typetanımlanan bir özel öznitelik dizisi döndürür. (Devralındığı yer: MemberInfo)
GetCustomAttributesData()	Hedef üyeye CustomAttributeData uygulanmış özniteliklerle ilgili verileri temsil eden nesnelerin listesini döndürür. (Devralındığı yer: MemberInfo)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür.
GetOtherMethods()	yönergesini kullanarak .other meta verilerdeki bir olayla ilişkilendirilmiş genel yöntemleri döndürür.
GetOtherMethods(Boolean)	yönergesini kullanarak .other meta verilerdeki olayla ilişkilendirilmiş yöntemleri döndürür ve genel olmayan yöntemlerin dahil edilip edilmeyeceğini belirtir.
GetRaiseMethod()	Olay tetiklendiğinde çağrılan yöntemi döndürür.
GetRaiseMethod(Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, olay tetiklendiğinde çağrılan yöntemi döndürür ve genel olmayan yöntemlerin döndürülip döndürülmeyeceğini belirtir.
GetRemoveMethod()	Olay kaynağından bir olay işleyici temsilcisini kaldırmak için kullanılan yöntemi döndürür.
GetRemoveMethod(Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, olayın bir yöntemini kaldırmak için nesnesini alır MethodInfo ve genel olmayan yöntemlerin döndürülip döndürülmeyeceğini belirtir.
GetType()	Bir üyenin özniteliklerini bulur ve üye meta verilerine erişim sağlar. (Devralındığı yer: MemberInfo)
HasSameMetadataDefinitionAs(MemberInfo)	Bir olayın özniteliklerini bulur ve olay meta verilerine erişim sağlar. (Devralındığı yer: MemberInfo)
IsDefined(Type, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen türde veya türetilmiş türlerinden bir veya daha fazla özniteliğin bu üyeye uygulanıp uygulanmadığını gösterir. (Devralındığı yer: MemberInfo)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RemoveEventHandler(Object, Delegate)	Olay kaynağından olay işleyicisini kaldırır.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

İşleçler

Equality(EventInfo, EventInfo)	İki EventInfo nesnenin eşit olup olmadığını gösterir.
Inequality(EventInfo, EventInfo)	İki EventInfo nesnenin eşit olup olmadığını gösterir.

Uzantı Metotları

GetCustomAttribute(MemberInfo, Type)	Belirtilen üyeye uygulanan belirtilen türde bir özel özniteliği alır.
GetCustomAttribute(MemberInfo, Type, Boolean)	Belirtilen bir üyeye uygulanan belirtilen türde bir özel özniteliği alır ve isteğe bağlı olarak bu üyenin üstlerini inceler.
GetCustomAttribute<T>(MemberInfo)	Belirtilen üyeye uygulanan belirtilen türde bir özel özniteliği alır.
GetCustomAttribute<T>(MemberInfo, Boolean)	Belirtilen bir üyeye uygulanan belirtilen türde bir özel özniteliği alır ve isteğe bağlı olarak bu üyenin üstlerini inceler.
GetCustomAttributes(MemberInfo)	Belirtilen üyeye uygulanan özel özniteliklerden oluşan bir koleksiyonu alır.
GetCustomAttributes(MemberInfo, Boolean)	Belirtilen üyeye uygulanan özel özniteliklerden oluşan bir koleksiyonu alır ve isteğe bağlı olarak bu üyenin atalarını inceler.
GetCustomAttributes(MemberInfo, Type)	Belirtilen üyeye uygulanan belirtilen türde özel özniteliklerden oluşan bir koleksiyonu alır.
GetCustomAttributes(MemberInfo, Type, Boolean)	Belirtilen bir üyeye uygulanan belirtilen türdeki özel özniteliklerden oluşan bir koleksiyonu alır ve isteğe bağlı olarak bu üyenin üst öğelerini inceler.
GetCustomAttributes<T>(MemberInfo)	Belirtilen üyeye uygulanan belirtilen türde özel özniteliklerden oluşan bir koleksiyonu alır.
GetCustomAttributes<T>(MemberInfo, Boolean)	Belirtilen bir üyeye uygulanan belirtilen türdeki özel özniteliklerden oluşan bir koleksiyonu alır ve isteğe bağlı olarak bu üyenin üst öğelerini inceler.
IsDefined(MemberInfo, Type)	Belirtilen türe ait özel özniteliklerin belirtilen üyeye uygulanıp uygulanmadığını gösterir.
IsDefined(MemberInfo, Type, Boolean)	Belirtilen türe ait özel özniteliklerin belirtilen bir üyeye uygulanıp uygulanmadığını ve isteğe bağlı olarak üstlerine uygulanıp uygulanmadığını gösterir.
GetAddMethod(EventInfo)	Bir olayın özniteliklerini bulur ve olay meta verilerine erişim sağlar.
GetAddMethod(EventInfo, Boolean)	Bir olayın özniteliklerini bulur ve olay meta verilerine erişim sağlar.
GetRaiseMethod(EventInfo)	Bir olayın özniteliklerini bulur ve olay meta verilerine erişim sağlar.
GetRaiseMethod(EventInfo, Boolean)	Bir olayın özniteliklerini bulur ve olay meta verilerine erişim sağlar.
GetRemoveMethod(EventInfo)	Bir olayın özniteliklerini bulur ve olay meta verilerine erişim sağlar.
GetRemoveMethod(EventInfo, Boolean)	Bir olayın özniteliklerini bulur ve olay meta verilerine erişim sağlar.
GetMetadataToken(MemberInfo)	Varsa, verilen üye için bir meta veri belirteci alır.
HasMetadataToken(MemberInfo)	Belirtilen üye için bir meta veri belirtecinin kullanılabilir olup olmadığını gösteren bir değer döndürür.

İş Parçacığı Güvenliği

Bu güvenli iş parçacığı türüdür.