Type.GetMembers 方法

定义

命名空间:

System

程序集:

netstandard.dll, System.Runtime.dll

获取当前 Type成员（属性、方法、字段、事件等）。

重载

名称	说明
GetMembers()	返回当前 Type的所有公共成员。
GetMembers(BindingFlags)	在派生类中重写时，使用指定的绑定约束搜索为当前 Type定义的成员。

GetMembers()

Source:

Type.cs

返回当前 Type的所有公共成员。

public:
 cli::array <System::Reflection::MemberInfo ^> ^ GetMembers();

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicFields | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicNestedTypes | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
public System.Reflection.MemberInfo[] GetMembers();

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicFields | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicNestedTypes | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
member this.GetMembers : unit -> System.Reflection.MemberInfo[]

Public Function GetMembers () As MemberInfo()

返回

MemberInfo[]

表示当前MemberInfo所有公共成员的对象数组Type。

-或-

如果当前MemberInfo没有公共成员，则为空数组类型Type。

属性

DynamicallyAccessedMembersAttribute

示例

下面的代码示例演示如何使用 GetMembers() 方法重载收集有关指定类的所有公共成员的信息。

class MyClass
{
   public int myInt = 0;
   public string myString = null;

   public MyClass()
   {
   }
   public void Myfunction()
   {
   }
}

class Type_GetMembers
{
   public static void Main()
   {
      try
      {
         MyClass myObject = new MyClass();
         MemberInfo[] myMemberInfo;

         // Get the type of 'MyClass'.
         Type myType = myObject.GetType();

         // Get the information related to all public member's of 'MyClass'.
         myMemberInfo = myType.GetMembers();

         Console.WriteLine( "\nThe members of class '{0}' are :\n", myType);
         for (int i =0 ; i < myMemberInfo.Length ; i++)
         {
            // Display name and type of the concerned member.
            Console.WriteLine( "'{0}' is a {1}", myMemberInfo[i].Name, myMemberInfo[i].MemberType);
         }
      }
      catch(SecurityException e)
      {
         Console.WriteLine("Exception : " + e.Message );
      }
   }
}

type MyClass =
    val public myInt: int
    val public myString: string

    new () = { myInt = 0; myString = null}

    member _.MyMethod() = ()

try
    let myObject = MyClass()

    // Get the type of 'MyClass'.
    let myType = myObject.GetType()

    // Get the information related to all public member's of 'MyClass'.
    let myMemberInfo = myType.GetMembers()

    printfn $"\nThe members of class '{myType}' are :\n"
    for i = 0 to myMemberInfo.Length - 1 do
    // Display name and type of the concerned member.
        printfn $"'{myMemberInfo[i].Name}' is a {myMemberInfo[i].MemberType}"
with e ->
    printfn $"Exception : {e.Message}"

Class [MyClass]
   Public myInt As Integer = 0
   Public myString As String = Nothing
   
   
   Public Sub New()
   End Sub
   
   Public Sub Myfunction()
   End Sub
End Class

Class Type_GetMembers
   
   Public Shared Sub Main()
      Try
         Dim myObject As New [MyClass]()
         Dim myMemberInfo() As MemberInfo
         
         ' Get the type of 'MyClass'.
         Dim myType As Type = myObject.GetType()
         
         ' Get the information related to all public member's of 'MyClass'. 
         myMemberInfo = myType.GetMembers()
         
         Console.WriteLine(ControlChars.Cr + "The members of class '{0}' are :" + ControlChars.Cr, myType)
         Dim i As Integer
         For i = 0 To myMemberInfo.Length - 1
            ' Display name and type of the concerned member.
            Console.WriteLine("'{0}' is a {1}", myMemberInfo(i).Name, myMemberInfo(i).MemberType)
         Next i

      Catch e As SecurityException
         Console.WriteLine(("Exception : " + e.Message.ToString()))
      End Try
   End Sub
End Class

注解

成员包括属性、方法、构造函数、字段、事件和嵌套类型。

在 .NET 6 及更早版本中，GetMembers 方法不会按特定顺序（如字母顺序或声明顺序）返回成员。 您的代码不得依赖于返回成员的顺序，因为该顺序会有所不同。 但是，从 .NET 7 开始，排序是基于程序集中的元数据排序确定性的。

此方法重载调用 GetMembers(BindingFlags) 方法重载，BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static （BindingFlags.PublicOrBindingFlags.InstanceOrBindingFlags.Static Visual Basic）。 它找不到类初始值设定项（静态构造函数）。 若要查找类初始值设定项，请调用 GetMembers(BindingFlags) 重载，并在 Visual Basic 中指定 BindingFlags.Static | BindingFlags.NonPublic （BindingFlags.StaticOrBindingFlags.NonPublic）。 还可以使用 TypeInitializer 属性获取类初始值设定项。

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

成员类型	Static	非静态
构造函数	否	否
领域	否	Yes. 字段始终是按名称和签名隐藏的。
事件	不適用	常见的类型系统规则是继承与实现属性的方法相同。 反射将属性视为按名称和签名隐藏。 请参阅下面的说明 2。
方法	否	Yes. 方法（虚拟和非虚拟）可以按名称隐藏或按名称和签名隐藏。
嵌套类型	否	否
财产	不適用	常见的类型系统规则是继承与实现属性的方法相同。 反射将属性视为按名称和签名隐藏。 请参阅下面的说明 2。

1. 按名称和签名隐藏会考虑签名的所有部分，包括自定义修饰符、返回类型、参数类型、sentinel 和非托管调用约定。 这是二进制比较。

2. 对于反射，属性和事件通过名称和签名进行隐藏。 如果基类中同时具有 get 和 set 访问器的属性，但派生类只有 get 访问器，则派生类属性将隐藏基类属性，并且无法访问基类上的 setter。

3. 自定义属性不是常见类型系统的一部分。

如果当前 Type 表示构造的泛型类型，此方法将返回 MemberInfo 具有由相应类型参数替换的类型参数的对象。

如果当前 Type 表示泛型类型或泛型方法定义中的类型参数，则此方法将搜索类约束的成员，或者不存在类约束的成员 Object 。

另请参阅

• MemberInfo
• GetMember(String)
• GetDefaultMembers()
• FindMembers(MemberTypes, BindingFlags, MemberFilter, Object)

GetMembers(BindingFlags)

Source:

Type.cs

在派生类中重写时，使用指定的绑定约束搜索为当前 Type定义的成员。

public:
 abstract cli::array <System::Reflection::MemberInfo ^> ^ GetMembers(System::Reflection::BindingFlags bindingAttr);

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicFields | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicMethods | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicNestedTypes | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicProperties | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicFields | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicNestedTypes | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
public abstract System.Reflection.MemberInfo[] GetMembers(System.Reflection.BindingFlags bindingAttr);

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicFields | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicMethods | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicNestedTypes | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicProperties | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicEvents | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicFields | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicNestedTypes | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
abstract member GetMembers : System.Reflection.BindingFlags -> System.Reflection.MemberInfo[]

Public MustOverride Function GetMembers (bindingAttr As BindingFlags) As MemberInfo()

参数

bindingAttr

BindingFlags

枚举值的按位组合，用于指定如何执行搜索。

-或-

Default 返回空数组。

返回

MemberInfo[]

一个 MemberInfo 对象数组，表示为与指定绑定约束匹配的当前 Type 定义的所有成员。

-或-

如果没有为当前 Type定义成员，或者未定义任何成员与绑定约束匹配，则为空数组。

实现

GetMembers(BindingFlags)

属性

DynamicallyAccessedMembersAttribute

示例

下面的代码示例演示如何使用 GetMembers(BindingFlags) 方法重载收集有关指定类的所有公共实例成员的信息。

class MyClass
{
   public int myInt = 0;
   public string myString = null;

   public MyClass()
   {
   }
   public void Myfunction()
   {
   }
}

class Type_GetMembers_BindingFlags
{
   public static void Main()
   {
      try
      {
         MyClass MyObject = new MyClass();
         MemberInfo [] myMemberInfo;

         // Get the type of the class 'MyClass'.
         Type myType = MyObject.GetType();

         // Get the public instance members of the class 'MyClass'.
         myMemberInfo = myType.GetMembers(BindingFlags.Public|BindingFlags.Instance);

         Console.WriteLine( "\nThe public instance members of class '{0}' are : \n", myType);
         for (int i =0 ; i < myMemberInfo.Length ; i++)
         {
            // Display name and type of the member of 'MyClass'.
            Console.WriteLine( "'{0}' is a {1}", myMemberInfo[i].Name, myMemberInfo[i].MemberType);
         }
      }
      catch (SecurityException e)
      {
         Console.WriteLine("SecurityException : " + e.Message );
      }

      //Output:
      //The public instance members of class 'MyClass' are :

      //'Myfunction' is a Method
      //'ToString' is a Method
      //'Equals' is a Method
      //'GetHashCode' is a Method
      //'GetType' is a Method
      //'.ctor' is a Constructor
      //'myInt' is a Field
      //'myString' is a Field
   }
}

open System.Reflection
open System.Security

type MyClass =
    val public myInt: int
    val public myString: string

    new () = { myInt = 0; myString = null}

    member _.MyMethod() = ()

try
    let MyObject = MyClass()

    // Get the type of the class 'MyClass'.
    let myType = MyObject.GetType()

    // Get the public instance members of the class 'MyClass'.
    let myMemberInfo = myType.GetMembers(BindingFlags.Public ||| BindingFlags.Instance)

    printfn $"\nThe public instance members of class '{myType}' are : \n"
    for i = 0 to myMemberInfo.Length - 1 do
        // Display name and type of the member of 'MyClass'.
        printfn $"'{myMemberInfo[i].Name}' is a {myMemberInfo[i].MemberType}"
with :? SecurityException as e ->
    printfn $"SecurityException : {e.Message}"

//Output:
//The public instance members of class 'MyClass' are :

//'Myfunction' is a Method
//'ToString' is a Method
//'Equals' is a Method
//'GetHashCode' is a Method
//'GetType' is a Method
//'.ctor' is a Constructor
//'myInt' is a Field
//'myString' is a Field

Class [MyClass]
   Public myInt As Integer = 0
   Public myString As String = Nothing
   
   
   Public Sub New()
   End Sub
   
   Public Sub Myfunction()
   End Sub
End Class

Class Type_GetMembers_BindingFlags
   
   Public Shared Sub Main()
      Try
         Dim MyObject As New [MyClass]()
         Dim myMemberInfo() As MemberInfo
         
         ' Get the type of the class 'MyClass'.
         Dim myType As Type = MyObject.GetType()
         
         ' Get the public instance members of the class 'MyClass'. 
         myMemberInfo = myType.GetMembers((BindingFlags.Public Or BindingFlags.Instance))
         
         Console.WriteLine(ControlChars.Cr + "The public instance members of class '{0}' are : " + ControlChars.Cr, myType)
         Dim i As Integer
         For i = 0 To myMemberInfo.Length - 1
            ' Display name and type of the member of 'MyClass'.
            Console.WriteLine("'{0}' is a {1}", myMemberInfo(i).Name, myMemberInfo(i).MemberType)
         Next i
      
      Catch e As SecurityException
         Console.WriteLine(("SecurityException : " + e.Message.ToString()))
      End Try


      'Output:
      'The public instance members of class 'MyClass' are :

      ''Myfunction' is a Method
      ''ToString' is a Method
      ''Equals' is a Method
      ''GetHashCode' is a Method
      ''GetType' is a Method
      ''.ctor' is a Constructor
      ''myInt' is a Field
      ''myString' is a Field


   End Sub
End Class

注解

成员包括属性、方法、构造函数、字段、事件和嵌套类型。

GetMethods(BindingFlags)要使重载能够成功检索方法信息，参数bindingAttr必须至少包含其中一个BindingFlags.Instance，BindingFlags.Static以及至少一个和BindingFlags.NonPublic一个BindingFlags.Public。 唯一的例外是方法调用 BindingFlags.NonPublic，该方法返回有关嵌套类型的成员信息。

以下 BindingFlags 筛选器标志可用于定义要在搜索中包含哪些成员：

• 指定 BindingFlags.Instance 以包含实例方法。

• 指定 BindingFlags.Static 以包含静态方法。

• 指定 BindingFlags.Public 在搜索中包含公共方法。

• 指定 BindingFlags.NonPublic 在搜索中包含非公共方法（即私有、内部和受保护的方法）。 仅返回基类上的受保护方法和内部方法;基类上的私有方法不会返回。

• 指定 BindingFlags.FlattenHierarchy 为包含 public 层次结构中的静态成员和 protected 静态成员; private 不包括继承类中的静态成员。

• 单独指定 BindingFlags.Default 以返回空 MethodInfo 数组。

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

• BindingFlags.DeclaredOnly 如果仅搜索声明的成员 Type，则不搜索只是继承的成员。

有关详细信息，请参阅 System.Reflection.BindingFlags。

在 .NET 6 及更早版本中，GetMembers 方法不会按特定顺序（如字母顺序或声明顺序）返回成员。 您的代码不得依赖于返回成员的顺序，因为该顺序会有所不同。 但是，从 .NET 7 开始，排序是基于程序集中的元数据排序确定性的。

若要使用此方法重载获取类初始值设定项（静态构造函数），必须在 Visual Basic 中指定 BindingFlags.Static | BindingFlags.NonPublic （BindingFlags.StaticOrBindingFlags.NonPublic）。 还可以使用 TypeInitializer 属性获取类初始值设定项。

如果当前 Type 表示构造的泛型类型，此方法将返回 MemberInfo 具有由相应类型参数替换的类型参数的对象。

如果当前 Type 表示泛型类型或泛型方法定义中的类型参数，则此方法将搜索类约束的成员，或者不存在类约束的成员 Object 。

另请参阅

• MemberInfo
• BindingFlags
• DefaultBinder
• GetMember(String)
• GetDefaultMembers()
• FindMembers(MemberTypes, BindingFlags, MemberFilter, Object)