EventInfo EventInfo EventInfo EventInfo Class

定義

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

継承

ObjectObjectObjectObject

MemberInfoMemberInfoMemberInfoMemberInfo

EventInfoEventInfoEventInfoEventInfo

派生

ComAwareEventInfoComAwareEventInfoComAwareEventInfoComAwareEventInfo

属性

ClassInterfaceAttribute ComVisibleAttribute SerializableAttribute

実装

_EventInfo_EventInfo_EventInfo_EventInfo

例

次のコードを取得、EventInfoオブジェクト、Clickのイベント、Buttonクラス。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
Imports System.Reflection
Imports System.Security
Imports Microsoft.VisualBasic

' 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 'Main
End Class 'MyEventExample

注釈

使用して、EventInfoのコード例に示すように、イベント ハンドラーをフックするイベントを検査するクラス、AddEventHandlerメソッド。Use 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. デリゲートを呼び出すときにメソッドは 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でEventInfoときに、inheritパラメーターのGetCustomAttributesはtrue型階層については説明しません。Calling 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.