Type.GetEvents Type.GetEvents Type.GetEvents Type.GetEvents Method

정의

현재 Type에 의해 선언되거나 상속되는 이벤트를 가져옵니다.Gets the events that are declared or inherited by the current Type.

오버로드

GetEvents() GetEvents() GetEvents() GetEvents()

현재 Type에 의해 선언되거나 상속되는 모든 public 이벤트를 반환합니다.Returns all the public events that are declared or inherited by the current Type.

GetEvents(BindingFlags) GetEvents(BindingFlags) GetEvents(BindingFlags) GetEvents(BindingFlags)

파생 클래스에서 재정의되면, 현재 Type에 의해 선언되거나 상속되는 이벤트를 지정된 바인딩 제약 조건으로 검색합니다.When overridden in a derived class, searches for events that are declared or inherited by the current Type, using the specified binding constraints.

GetEvents() GetEvents() GetEvents() GetEvents()

현재 Type에 의해 선언되거나 상속되는 모든 public 이벤트를 반환합니다.Returns all the public events that are declared or inherited by the current Type.

public:
 virtual cli::array <System::Reflection::EventInfo ^> ^ GetEvents();
public virtual System.Reflection.EventInfo[] GetEvents ();
abstract member GetEvents : unit -> System.Reflection.EventInfo[]
override this.GetEvents : unit -> System.Reflection.EventInfo[]
Public Overridable Function GetEvents () As EventInfo()

반환

현재 EventInfo에 의해 선언되거나 상속되는 모든 public 이벤트를 나타내는 Type 개체의 배열입니다.An array of EventInfo objects representing all the public events which are declared or inherited by the current Type.

또는-or- 현재 EventInfo에 public 이벤트가 없을 경우 Type 형식의 빈 배열입니다.An empty array of type EventInfo, if the current Type does not have public events.

구현

예제

다음 예제에서는 배열을 가져옵니다 EventInfo 개체에 대 한 모든 이벤트는 Button 클래스 및 이벤트 이름을 표시 합니다.The following example obtains an array of EventInfo objects, gets all the events for a Button class, and displays the event names. Visual Basic 예제를 컴파일하려면 다음 명령줄을 사용 합니다.To compile the Visual Basic example, use the following command line:

vbc type_getevents1.vb /r:System.Windows.Forms.dll /r:System.dll

#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;
      array<EventInfo^>^myEvents = myType->GetEvents();
      Console::WriteLine( "The events on the Button class are: " );
      for ( int index = 0; index < myEvents->Length; index++ )
      {
         Console::WriteLine( myEvents[ index ] );

      }
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "SecurityException: {0}", e->Message );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException: {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }
}
using System;
using System.Reflection;
using System.Security;

class EventsSample
{
    public static void Main()
    { 
        try
        {
            // Creates a bitmask based on BindingFlags.
            BindingFlags myBindingFlags = BindingFlags.Instance | BindingFlags.Public;  
            Type myTypeEvent = typeof(System.Windows.Forms.Button);
            EventInfo[] myEventsBindingFlags = myTypeEvent.GetEvents(myBindingFlags);
            Console.WriteLine("\nThe events on the Button class with the specified BindingFlags are : ");
            for (int index = 0; index < myEventsBindingFlags.Length; index++)
            {
                Console.WriteLine(myEventsBindingFlags[index].ToString());
            }
        }
        catch(SecurityException e)
        {
            Console.WriteLine("SecurityException :" + e.Message);
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException : " + e.Message);
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception : " + e.Message);
        }
    }
}
Imports System.Reflection
Imports System.Security

' Compile this sample using the following command line:
' vbc type_getevents.vb /r:"System.Windows.Forms.dll" /r:"System.dll"

Class EventsSample

    Public Shared Sub Main()
        Try
            ' Creates a bitmask based on BindingFlags.
            Dim myBindingFlags As BindingFlags = BindingFlags.Instance Or BindingFlags.Public
            Dim myTypeEvent As Type = GetType(System.Windows.Forms.Button)
            Dim myEventsBindingFlags As EventInfo() = myTypeEvent.GetEvents(myBindingFlags)
            Console.WriteLine(ControlChars.Cr + "The events on the Button class with the specified BindingFlags are : ")
            Dim index As Integer
            For index = 0 To myEventsBindingFlags.Length - 1
                Console.WriteLine(myEventsBindingFlags(index).ToString())
            Next index
        Catch e As SecurityException
            Console.WriteLine(("SecurityException :" + e.Message))
        Catch e As ArgumentNullException
            Console.WriteLine(("ArgumentNullException : " + e.Message))
        Catch e As Exception
            Console.WriteLine(("Exception : " + e.Message))
        End Try
    End Sub
End Class

설명

메서드 또는 공용 접근자를 하나 이상 있을 경우 이벤트 반사를 공용으로 간주 됩니다.An event is considered public to reflection if it has at least one method or accessor that is public. 그렇지 않은 경우 이벤트는 개인으로 간주 하 고 사용 해야 합니다 BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic에서 사용 하 여 값을 결합 Or) 가져오려고 합니다.Otherwise the event is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

GetEvents 메서드 반환 하지 않습니다 이벤트를 특정 순서로 같은 알파벳 또는 선언 순서입니다.The GetEvents method does not return events in a particular order, such as alphabetical or declaration order. 코드 영향을 받지 않아야 이벤트가 반환 되는 순서 때문에 순서가 달라 지는 합니다.Your code must not depend on the order in which events are returned, because that order varies.

이 메서드는 파생된 클래스에서 재정의할 수 있습니다.This method can be overridden by a derived class.

다음 표에서 메서드에서 반환 되는 기본 클래스의 멤버는 Get 메서드 형식에 반영 하는 경우.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

멤버 형식Member Type 정적Static Static이 아니고Non-Static
생성자Constructor 아니요No 아니요No
필드Field 아니요No 예.Yes. 필드는 항상 이름 및 서명에서 숨겨집니다.A field is always hide-by-name-and-signature.
이벤트Event 적용할 수 없음Not applicable 공용 형식 시스템 규칙의 상속 속성을 구현 하는 메서드의 것과 동일 된다는 것입니다.The common type system rule is that the inheritance is the same as that of the methods that implement the property. 리플렉션 속성 이름 및 서명으로 숨기기 취급 됩니다.Reflection treats properties as hide-by-name-and-signature. 참고 2 아래를 참조 하세요.See note 2 below.
메서드Method 아니요No 예.Yes. (가상 및 비가상) 메서드 이름에서 숨김 또는 이름 및 서명으로 숨기기 수 있습니다.A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
중첩된 형식Nested Type 아니요No 아니요No
속성Property 적용할 수 없음Not applicable 공용 형식 시스템 규칙의 상속 속성을 구현 하는 메서드의 것과 동일 된다는 것입니다.The common type system rule is that the inheritance is the same as that of the methods that implement the property. 리플렉션 속성 이름 및 서명으로 숨기기 취급 됩니다.Reflection treats properties as hide-by-name-and-signature. 참고 2 아래를 참조 하세요.See note 2 below.
  1. 이름 및 서명으로 숨기기 모든 사용자 지정 한정자를 포함 하 여 서명의 부분 반환 형식, 매개 변수 형식, 센티널, 및 관리 되지 않는 호출 규칙을 고려 합니다.Hide-by-name-and-signature considers all of the parts of the signature, including custom modifiers, return types, parameter types, sentinels, and unmanaged calling conventions. 이것은 이진 비교 합니다.This is a binary comparison.

  2. 리플렉션, 속성 및 이벤트는 이름 및 서명에서 숨겨집니다.For reflection, properties and events are hide-by-name-and-signature. 기본 클래스에서 get 및 set 접근자 모두를 사용 하 여 속성을 갖지만 파생된 클래스에 get 접근자만 하는 경우 파생된 클래스 속성을 기본 클래스 속성 숨기고 기본 클래스의 setter를 액세스할 수 없습니다.If you have a property with both a get and a set accessor in the base class, but the derived class has only a get accessor, the derived class property hides the base class property, and you will not be able to access the setter on the base class.

  3. 사용자 지정 특성의 일부분이 아닌 공용 형식 시스템입니다.Custom attributes are not part of the common type system.

하는 경우 현재 Type 이 메서드는 반환 생성된 된 제네릭 형식을 나타내는 EventInfo 따라 적절 한 형식 인수로 대체 형식 매개 변수를 사용 하 여 개체입니다.If the current Type represents a constructed generic type, this method returns the EventInfo objects with the type parameters replaced by the appropriate type arguments.

하는 경우 현재 Type 형식 매개 변수는 제네릭 형식 또는 제네릭 메서드 정의에서이 메서드는 클래스 제약 조건의 이벤트를 검색 합니다.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the events of the class constraint.

추가 정보

GetEvents(BindingFlags) GetEvents(BindingFlags) GetEvents(BindingFlags) GetEvents(BindingFlags)

파생 클래스에서 재정의되면, 현재 Type에 의해 선언되거나 상속되는 이벤트를 지정된 바인딩 제약 조건으로 검색합니다.When overridden in a derived class, searches for events that are declared or inherited by the current Type, using the specified binding constraints.

public:
 abstract cli::array <System::Reflection::EventInfo ^> ^ GetEvents(System::Reflection::BindingFlags bindingAttr);
public abstract System.Reflection.EventInfo[] GetEvents (System.Reflection.BindingFlags bindingAttr);
abstract member GetEvents : System.Reflection.BindingFlags -> System.Reflection.EventInfo[]
Public MustOverride Function GetEvents (bindingAttr As BindingFlags) As EventInfo()

매개 변수

bindingAttr
BindingFlags BindingFlags BindingFlags BindingFlags

검색 방법을 지정하는 열거형 값의 비트 조합입니다.A bitwise combination of the enumeration values that specify how the search is conducted.

또는-or-

빈 배열을 반환하는 Default입니다.Default to return an empty array.

반환

현재 EventInfo에 의해 선언되거나 상속되는 이벤트 중 지정된 바인딩 제약 조건과 일치하는 모든 이벤트를 나타내는 Type 개체의 배열입니다.An array of EventInfo objects representing all events that are declared or inherited by the current Type that match the specified binding constraints.

또는-or- 현재 EventInfo에 이벤트가 없거나 해당 바인딩 제약 조건과 일치하는 이벤트가 없을 경우 Type 형식의 빈 배열입니다.An empty array of type EventInfo, if the current Type does not have events, or if none of the events match the binding constraints.

구현

예제

다음 예제에서는 배열을 가져옵니다 EventInfo 지정 된 바인딩 플래그와 일치 하는 개체에 대 한 모든 이벤트를 가져옵니다는 Button 클래스 및 이벤트 이름을 표시 합니다.The following example obtains an array of EventInfo objects that match the specified binding flags, gets all the events for a Button class, and displays the event names. Visual Basic 예제를 컴파일하려면 다음 명령줄을 사용 합니다.To compile the Visual Basic example, use the following command line:

vbc type_getevents2.vb /r:System.Windows.Forms.dll /r:System.dll

#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
   {
      
      // Create a bitmask based on BindingFlags.
      BindingFlags myBindingFlags = static_cast<BindingFlags>(BindingFlags::Instance | BindingFlags::Public);
      Type^ myTypeEvent = System::Windows::Forms::Button::typeid;
      array<EventInfo^>^myEventsBindingFlags = myTypeEvent->GetEvents( myBindingFlags );
      Console::WriteLine( "\nThe events on the Button class with the specified BindingFlags are:" );
      for ( int index = 0; index < myEventsBindingFlags->Length; index++ )
      {
         Console::WriteLine( myEventsBindingFlags[ index ] );

      }
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "SecurityException: {0}", e->Message );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException: {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }
}
using System;
using System.Reflection;
using System.Security;

class EventsSample
{
    public static void Main()
    { 
        try
        {
            // Create a bitmask based on BindingFlags.
            BindingFlags myBindingFlags = BindingFlags.Instance | BindingFlags.Public;  
            Type myTypeEvent = typeof(System.Windows.Forms.Button);
            EventInfo[] myEventsBindingFlags = myTypeEvent.GetEvents(myBindingFlags);
            Console.WriteLine("\nThe events on the Button class with the specified BindingFlags are:");
            for (int index = 0; index < myEventsBindingFlags.Length; index++)
            {
                Console.WriteLine(myEventsBindingFlags[index].ToString());
            }
        }
        catch(SecurityException e)
        {
            Console.WriteLine("SecurityException:" + e.Message);
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException: " + e.Message);
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception: " + e.Message);
        }
    }
}
Imports System.Reflection
Imports System.Security
Imports System.Windows.Forms

Class EventsSample

    Public Shared Sub Main()
        Try
            ' Create a bitmask based on BindingFlags.
            Dim myBindingFlags As BindingFlags = BindingFlags.Instance Or BindingFlags.Public
            Dim myTypeEvent As Type = GetType(System.Windows.Forms.Button)
            Dim myEventsBindingFlags As EventInfo() = myTypeEvent.GetEvents(myBindingFlags)
            Console.WriteLine(ControlChars.Cr + "The events on the Button class with the specified BindingFlags are:")
            Dim index As Integer
            For index = 0 To myEventsBindingFlags.Length - 1
                Console.WriteLine(myEventsBindingFlags(index).ToString())
            Next index
        Catch e As SecurityException
            Console.WriteLine("SecurityException:" + e.Message)
        Catch e As ArgumentNullException
            Console.WriteLine("ArgumentNullException: " + e.Message)
        Catch e As Exception
            Console.WriteLine("Exception: " + e.Message)
        End Try
    End Sub
End Class

설명

GetEvents 메서드 반환 하지 않습니다 이벤트를 특정 순서로 같은 알파벳 또는 선언 순서입니다.The GetEvents method does not return events in a particular order, such as alphabetical or declaration order. 코드 영향을 받지 않아야 이벤트가 반환 되는 순서 때문에 순서가 달라 지는 합니다.Your code must not depend on the order in which events are returned, because that order varies.

다음 BindingFlags 필터 플래그를 사용 하 여 검색에 포함할 이벤트를 정의할 수 있습니다.The following BindingFlags filter flags can be used to define which events to include in the search:

  • 중 하나를 지정 해야 합니다 BindingFlags.Instance 또는 BindingFlags.Static 반환 합니다.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • 지정 BindingFlags.Public 검색에 공용 이벤트를 포함 하도록 합니다.Specify BindingFlags.Public to include public events in the search.

  • 지정 BindingFlags.NonPublic 검색에 public이 아닌 이벤트 (즉, 전용, 내부 및 보호 된 이벤트)를 포함 하도록 합니다.Specify BindingFlags.NonPublic to include non-public events (that is, private, internal, and protected events) in the search. 만 보호 하 고 기본 클래스의 내부 이벤트 반환 됩니다. 기본 클래스에서 private 이벤트 반환 되지 않습니다.Only protected and internal events on base classes are returned; private events on base classes are not returned.

  • 지정할 BindingFlags.FlattenHierarchy 하기로 publicprotected 정적 멤버를 계층 구조 private 상속 된 클래스의 정적 멤버가 포함 되지 않습니다.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

다음 BindingFlags 한정자 플래그를 사용 하 여 검색의 작동 방식을 변경할 수 있습니다.The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.DeclaredOnly 에 선언 된 이벤트만 검색 하는 Type, 상속 된 이벤트가 없습니다.BindingFlags.DeclaredOnly to search only the events declared on the Type, not events that were simply inherited.

자세한 내용은 System.Reflection.BindingFlags를 참조하세요.See System.Reflection.BindingFlags for more information.

메서드 또는 공용 접근자를 하나 이상 있을 경우 이벤트 반사를 공용으로 간주 됩니다.An event is considered public to reflection if it has at least one method or accessor that is public. 그렇지 않은 경우 이벤트는 개인으로 간주 하 고 사용 해야 합니다 BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic에서 사용 하 여 값을 결합 Or) 가져오려고 합니다.Otherwise the event is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

하는 경우 현재 Type 이 메서드는 반환 생성된 된 제네릭 형식을 나타내는 EventInfo 따라 적절 한 형식 인수로 대체 형식 매개 변수를 사용 하 여 개체입니다.If the current Type represents a constructed generic type, this method returns the EventInfo objects with the type parameters replaced by the appropriate type arguments.

하는 경우 현재 Type 형식 매개 변수는 제네릭 형식 또는 제네릭 메서드 정의에서이 메서드는 클래스 제약 조건의 이벤트를 검색 합니다.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the events of the class constraint.

추가 정보

적용 대상