Type.FindMembers(MemberTypes, BindingFlags, MemberFilter, Object) Метод

Определение

Возвращает отфильтрованный массив объектов MemberInfo, тип которого совпадает с указанным типом члена.Returns a filtered array of MemberInfo objects of the specified member type.

public:
 virtual cli::array <System::Reflection::MemberInfo ^> ^ FindMembers(System::Reflection::MemberTypes memberType, System::Reflection::BindingFlags bindingAttr, System::Reflection::MemberFilter ^ filter, System::Object ^ filterCriteria);
public virtual System.Reflection.MemberInfo[] FindMembers (System.Reflection.MemberTypes memberType, System.Reflection.BindingFlags bindingAttr, System.Reflection.MemberFilter filter, object filterCriteria);
abstract member FindMembers : System.Reflection.MemberTypes * System.Reflection.BindingFlags * System.Reflection.MemberFilter * obj -> System.Reflection.MemberInfo[]
override this.FindMembers : System.Reflection.MemberTypes * System.Reflection.BindingFlags * System.Reflection.MemberFilter * obj -> System.Reflection.MemberInfo[]
Public Overridable Function FindMembers (memberType As MemberTypes, bindingAttr As BindingFlags, filter As MemberFilter, filterCriteria As Object) As MemberInfo()

Параметры

memberType
MemberTypes

Побитовое сочетание значений перечисления, обозначающее тип искомого члена.A bitwise combination of the enumeration values that indicates the type of member to search for.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающих способ проведения поиска.A bitwise combination of the enumeration values that specify how the search is conducted.

- или --or- Default для возврата null.Default to return null.

filter
MemberFilter

Делегат, выполняющий сравнение и возвращающий true, если проверяемый член соответствует условиям, заданным в параметре filterCriteria, и false в противном случае.The delegate that does the comparisons, returning true if the member currently being inspected matches the filterCriteria and false otherwise.

filterCriteria
Object

Условие поиска, определяющее, будет ли член включен в возвращаемый массив объектов MemberInfo.The search criteria that determines whether a member is returned in the array of MemberInfo objects.

Поля классов FieldAttributes, MethodAttributes и MethodImplAttributes могут использоваться вместе с делегатом FilterAttribute, предоставляемым этим классом.The fields of FieldAttributes, MethodAttributes, and MethodImplAttributes can be used in conjunction with the FilterAttribute delegate supplied by this class.

Возвраты

Отфильтрованный массив объектов MemberInfo, имеющих тип указанного члена.A filtered array of MemberInfo objects of the specified member type.

- или --or- Пустой массив, если у текущего Type нет членов типа memberType, удовлетворяющих условиям фильтра.An empty array if the current Type does not have members of type memberType that match the filter criteria.

Реализации

Исключения

filternull.filter is null.

Примеры

В следующем примере выполняется поиск всех элементов в классе, соответствующих указанным условиям поиска, а затем отображаются сопоставленные члены.The following example finds all the members in a class that match the specified search criteria, and then displays the matched members.

using namespace System;
using namespace System::Reflection;
ref class MyFindMembersClass
{
public:
   static void Test()
   {
      Object^ objTest = gcnew Object;
      Type^ objType = objTest->GetType();
      array<MemberInfo^>^arrayMemberInfo;
      try
      {
         
         //Find all static or public methods in the Object class that match the specified name.
         arrayMemberInfo = objType->FindMembers( MemberTypes::Method, static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Static | BindingFlags::Instance), gcnew MemberFilter( DelegateToSearchCriteria ), "ReferenceEquals" );
         for ( int index = 0; index < arrayMemberInfo->Length; index++ )
            Console::WriteLine( "Result of FindMembers -\t {0}", String::Concat( arrayMemberInfo[ index ], "\n" ) );
      }
      catch ( Exception^ e ) 
      {
         Console::WriteLine( "Exception : {0}", e );
      }

   }

   static bool DelegateToSearchCriteria( MemberInfo^ objMemberInfo, Object^ objSearch )
   {
      
      // Compare the name of the member function with the filter criteria.
      if ( objMemberInfo->Name->Equals( objSearch->ToString() ) )
            return true;
      else
            return false;
   }

};

int main()
{
   MyFindMembersClass::Test();
}

using System;
using System.Reflection;

class MyFindMembersClass
{
    public static void Main()
    {
        Object objTest = new Object();
        Type objType = objTest.GetType ();
        MemberInfo[] arrayMemberInfo;
        try
        {
            //Find all static or public methods in the Object class that match the specified name.
            arrayMemberInfo = objType.FindMembers(MemberTypes.Method,
                BindingFlags.Public | BindingFlags.Static| BindingFlags.Instance,
                new MemberFilter(DelegateToSearchCriteria),
                "ReferenceEquals");

            for(int index=0;index < arrayMemberInfo.Length ;index++)
                Console.WriteLine ("Result of FindMembers -\t"+ arrayMemberInfo[index].ToString() +"\n");                 
        }
        catch (Exception e)
        {
            Console.WriteLine ("Exception : " + e.ToString() );            
        }           
    }
    public static bool DelegateToSearchCriteria(MemberInfo objMemberInfo, Object objSearch)
    {
        // Compare the name of the member function with the filter criteria.
        if(objMemberInfo.Name.ToString() == objSearch.ToString())
            return true;
        else 
            return false;
    }
}

Imports System.Reflection

Class MyFindMembersClass

    Public Shared Sub Main()
        Dim objTest As New Object()
        Dim objType As Type = objTest.GetType()
        Dim arrayMemberInfo() As MemberInfo
        Try
            'Find all static or public methods in the Object 
            'class that match the specified name.
            arrayMemberInfo = objType.FindMembers(MemberTypes.Method, _
                              BindingFlags.Public Or BindingFlags.Static _
                              Or BindingFlags.Instance, _
                              New MemberFilter(AddressOf DelegateToSearchCriteria), _
                              "ReferenceEquals")

            Dim index As Integer
            For index = 0 To arrayMemberInfo.Length - 1
                Console.WriteLine("Result of FindMembers -" + ControlChars.Tab + _
                               arrayMemberInfo(index).ToString() + ControlChars.Cr)
            Next index
        Catch e As Exception
            Console.WriteLine("Exception : " + e.ToString())
        End Try
    End Sub

    Public Shared Function DelegateToSearchCriteria _
                            (ByVal objMemberInfo As MemberInfo, _
                             ByVal objSearch As Object) As Boolean
        ' Compare the name of the member function with the filter criteria.
        If objMemberInfo.Name.ToString() = objSearch.ToString() Then
            Return True
        Else
            Return False
        End If
    End Function 'DelegateToSearchCriteria 
End Class

Комментарии

Этот метод может быть переопределен производным классом.This method can be overridden by a derived class.

Элементы включают свойства, методы, поля, события и т. д.Members include properties, methods, fields, events, and so on.

Чтобы метод FindMembers успешно получал сведения об элементе, аргумент bindingAttr должен включать по крайней мере один из BindingFlags.Instance и BindingFlags.Static, а также хотя бы один из BindingFlags.NonPublic и BindingFlags.Public.For the FindMembers method to successfully retrieve member information, the bindingAttr argument must include at least one of BindingFlags.Instance and BindingFlags.Static, along with at least one of BindingFlags.NonPublic and BindingFlags.Public.

Для определения элементов, включаемых в поиск, можно использовать следующие флаги фильтра BindingFlags.The following BindingFlags filter flags can be used to define which members to include in the search:

  • Укажите BindingFlags.Instance, чтобы включить в поиск члены экземпляра.Specify BindingFlags.Instance to include instance members in the search.

  • Укажите BindingFlags.Static, чтобы включить в поиск статические элементы.Specify BindingFlags.Static to include static members in the search.

  • Укажите BindingFlags.Public, чтобы включить в поиск открытые члены.Specify BindingFlags.Public to include public members in the search.

  • Укажите BindingFlags.NonPublic, чтобы включить в поиск неоткрытые члены (т. е. частные, внутренние и защищенные члены).Specify BindingFlags.NonPublic to include non-public members (that is, private, internal, and protected members) in the search.

Для изменения работы поиска можно использовать следующие флаги модификатора BindingFlags.The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.DeclaredOnly искать только члены, объявленные в Type, а не члены, которые были просто унаследованы.BindingFlags.DeclaredOnly to search only the members declared on the Type, not members that were simply inherited.

Дополнительные сведения см. в разделе System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

Чтобы получить инициализатор класса (статический конструктор) с помощью этого метода, необходимо указать BindingFlags.Static | BindingFlags.NonPublic (BindingFlags.StaticOrBindingFlags.NonPublic в Visual Basic).To get the class initializer (static constructor) using this method, you must specify BindingFlags.Static | BindingFlags.NonPublic (BindingFlags.StaticOrBindingFlags.NonPublic in Visual Basic). Инициализатор класса также можно получить с помощью свойства TypeInitializer.You can also get the class initializer using the TypeInitializer property.

Если текущий Type представляет параметр типа универсального типа или универсального метода, FindMembers обрабатывает все члены, объявленные ограничением класса, и ограничения интерфейса параметра типа.If the current Type represents a type parameter of a generic type or generic method, FindMembers processes any members declared by the class constraint and the interface constraints of the type parameter.

Аргумент filter может быть пользовательским делегатом типа MemberFilterили одним из следующих предопределенных делегатов:The filter argument can be a custom delegate of type MemberFilter, or it can be one of the following predefined delegates:

Применяется к

Дополнительно