EventInfo クラス

定義

public ref class EventInfo abstract : System::Reflection::MemberInfo, System::Runtime::InteropServices::_EventInfo

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class EventInfo : System.Reflection.MemberInfo, System.Runtime.InteropServices._EventInfo

type EventInfo = class
    inherit MemberInfo
    interface _EventInfo

Public MustInherit Class EventInfo
Inherits MemberInfo
Implements _EventInfo

継承

Object

MemberInfo

EventInfo

派生

System.Runtime.InteropServices.ComAwareEventInfo

属性

ClassInterfaceAttribute ComVisibleAttribute SerializableAttribute

実装

_EventInfo

例

次のコードは、 EventInfo ButtonクラスのClickイベントのオブジェクトを取得します。The following code gets an EventInfo object for the Click event of the Button class.

#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

注釈

メソッドのコード例に示すように、クラスを使用してイベントを検査し、イベントハンドラーをフックします。EventInfo AddEventHandlerUse the EventInfo class to inspect events and to hook up event handlers, as shown in the example code for the AddEventHandler method.

イベントはデリゲートと共に使用されます。Events are used with delegates. イベントリスナーは、イベントソースによってイベントが発生するたびに呼び出されるイベントハンドラーデリゲートをインスタンス化します。An event listener instantiates an event-handler delegate that is invoked whenever the event is raised by an event source. イベントソースに接続するために、イベントリスナーは、このデリゲートをソースの呼び出しリストに追加します。In order to connect to the event source, the event listener adds this delegate to the invocation list on the source. イベントが発生すると、イベントハンドラーデリゲートの invoke メソッドが呼び出されます。When the event is raised, the invoke method of the event-handler delegate is called. マルチキャストイベント通知とシングルキャストイベント通知の両方がサポートされています。Both multicast and single-cast event notifications are supported. イベントAddにRemove関連付けられているイベントハンドラーデリゲートクラスに加えて、メソッドとメソッドは、メタデータでマークされている必要があります。The Add and Remove methods, as well as the event-handler delegate class associated with an event, must be marked in the metadata.

デリゲートはオブジェクト指向の関数ポインターです。Delegates are object-oriented function pointers. C またはC++では、関数ポインターはメソッドへの参照です。In C or C++, a function pointer is a reference to a method. C またはC++関数ポインターとは異なり、デリゲートには、メソッドへの参照と、メソッドをサポートするオブジェクトへの参照の2つの参照が含まれます。In contrast to the C or C++ function pointer, a delegate contains two references: a reference to a method and a reference to an object that supports the method. デリゲートは、メソッドを宣言または継承するクラス型を知らなくてもメソッドを呼び出すことができます。Delegates can invoke a method without knowing the class type that declares or inherits the method. デリゲートは、メソッドの戻り値の型とパラメーターリストのみを必要とします。Delegates need only know the return type and parameter list of the method.

イベントモデルは、シングルキャストデリゲートとマルチキャストデリゲートでも同様に機能します。The event model works equally well for single-cast and multicast delegates. デリゲートの invoke メソッドが呼び出されると、1つのオブジェクトに対してメソッドが呼び出されます。When the delegate's invoke method is called, only a single object will have a method called on it. マルチキャスト修飾子はデリゲート宣言に適用できます。これにより、デリゲートの invoke メソッドが呼び出されたときに、複数のメソッドを呼び出すことができます。A multicast modifier can be applied to a delegate declaration, which allows multiple methods to be called when the invoke method of the delegate is called.

のICustomAttributeProvider.GetCustomAttributes inheritパラメーター EventInfoがの場合GetCustomAttributesにを呼び出すと、型階層がウォークされません。 trueCalling ICustomAttributeProvider.GetCustomAttributes on EventInfo when the inherit parameter of GetCustomAttributes is true does not walk the type hierarchy. カスタムSystem.Attribute属性を継承するには、を使用します。Use System.Attribute to inherit custom attributes.

注意 (実装者)

からEventInfo継承する場合はGetAddMethod(Boolean)、、 GetRemoveMethod(Boolean)、およびGetRaiseMethod(Boolean)の各メンバーをオーバーライドする必要があります。When you inherit from EventInfo, you must override the following members: GetAddMethod(Boolean), GetRemoveMethod(Boolean), and GetRaiseMethod(Boolean).

コンストラクター

プロパティ

メソッド

演算子

明示的なインターフェイスの実装

拡張メソッド

セキュリティ

InheritanceDemand
継承者に対する完全な信頼の場合。for full trust for inheritors. このクラスを、部分的に信頼されているコードが継承することはできません。This class cannot be inherited by partially trusted code.

適用対象

スレッド セーフ

この型はスレッド セーフです。This type is thread safe.