Type.GetEvent 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.dll

程序集:: netstandard.dll

程序集:: mscorlib.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取由当前 Type 声明或继承的特定事件。

重载

GetEvent(String, BindingFlags)	当在派生类中重写时，使用指定绑定约束，返回表示指定事件的 EventInfo 对象。
GetEvent(String)	返回表示指定的公共事件的 EventInfo 对象。

GetEvent(String, BindingFlags)

当在派生类中重写时，使用指定绑定约束，返回表示指定事件的 EventInfo 对象。

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

参数

name: String

字符串包含由当前的 Type 声明或继承的事件的名称。

bindingAttr: BindingFlags

枚举值的按位组合，这些值指定如何进行搜索。

或 - 若为 Default，则返回 null。

EventInfo

如找到，则为表示由当前 Type 声明或继承的指定公共事件的对象；否则为 null。

实现

GetEvent(String, BindingFlags)

例外

ArgumentNullException

name 上声明的默认值为 null。

示例

下面的代码示例使用 GetEvent(String, BindingFlags) 方法在类型中搜索名为 "单击" 的公共或非公共事件，该事件不 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

注解

以下 BindingFlags 筛选器标志可用于定义要包括在搜索中的事件：

必须指定 BindingFlags.Instance 或 BindingFlags.Static 才能获取返回。
指定 BindingFlags.Public 在搜索中包括公共事件。
指定 BindingFlags.NonPublic 以包括搜索中) 的非公共事件 (即私有、内部和受保护事件。
指定在 BindingFlags.FlattenHierarchy public protected 层次结构中包含和静态成员; private 不包括继承类中的静态成员。

以下 BindingFlags 修饰符标志可用于更改搜索的工作方式：

BindingFlags.IgnoreCase 如果忽略，则为 name 。
BindingFlags.DeclaredOnly 仅搜索在上声明的事件 Type ，而不搜索只是继承的事件。

有关更多信息，请参见System.Reflection.BindingFlags。

如果某个事件至少有一个公共方法或访问器，则该事件将被视为 "公共"。否则，该事件将被视为私有事件，并且必须使用 BindingFlags.NonPublic BindingFlags.Instance BindingFlags.Static Visual Basic 中 | | (，并使用 Or) 来合并这些值。

如果当前 Type 表示构造泛型类型，则此方法将返回， EventInfo 并将类型参数替换为相应的类型参数。

如果当前 Type 表示泛型类型或泛型方法的定义中的类型参数，则此方法会搜索类约束的事件。

另请参阅

适用于

GetEvent(String)

返回表示指定的公共事件的 EventInfo 对象。

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

参数

name: String

该字符串包含事件名称，该事件是由当前 Type 声明或继承的。

EventInfo

如找到，则为表示由当前 Type 声明或继承的指定公共事件的对象；否则为 null。

实现

GetEvent(String)

例外

ArgumentNullException

name 上声明的默认值为 null。

示例

下面的示例创建一个 EventInfo 对象，并为指定的事件获取按钮类的事件。

#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

注解

的搜索 name 区分大小写。搜索包括公共静态和公共实例事件。

下表显示了 Get 在类型上反射时方法返回的基类成员。

成员类型	静态	非静态
构造函数	否	否
字段	否	可以。字段始终按名称和签名隐藏。
事件	不适用	通用类型系统规则是指继承与实现属性的方法相同。反射将属性视为隐藏的名称和签名。请参阅下面的注释2。
方法	否	可以。虚拟和非虚拟) (方法可以是按名称隐藏或按名称和签名隐藏。
嵌套类型	否	否
properties	不适用	通用类型系统规则是指继承与实现属性的方法相同。反射将属性视为隐藏的名称和签名。请参阅下面的注释2。

按名称和签名隐藏将考虑签名的所有部分，包括自定义修饰符、返回类型、参数类型、个 sentinel 和非托管调用约定。这是二进制比较。
对于反射，属性和事件是按名称和签名隐藏的。如果在基类中同时具有 get 访问器和 set 访问器的属性，但派生类只有 get 访问器，则派生类属性将隐藏基类属性，并且你将无法访问基类的资源库。
自定义属性不属于通用类型系统。

如果当前 Type 表示构造泛型类型，则此方法将返回， EventInfo 并将类型参数替换为相应的类型参数。

如果当前 Type 表示泛型类型或泛型方法的定义中的类型参数，则此方法会搜索类约束的事件。

另请参阅

适用于

Type.GetEvent 方法

定义

重载

GetEvent(String, BindingFlags)

参数

返回

实现

例外

示例

注解

另请参阅

适用于

GetEvent(String)

参数

返回

实现

例外

示例

注解

另请参阅

适用于

其他资源