Type.FindMembers(MemberTypes, BindingFlags, MemberFilter, Object) Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: Type.Helpers.cs

Quelle:: Type.Helpers.cs

Quelle:: Type.Helpers.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt ein gefiltertes Array von MemberInfo-Objekten mit dem angegebenen Membertyp zurück.

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);

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()

Parameter

memberType: MemberTypes

Eine bitweise Kombination von Enumerationswerten, die angibt, welcher Membertyp gesucht werden soll.

bindingAttr: BindingFlags

Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird.

- oder -

Default, damit null zurückgegeben wird.

filter: MemberFilter

Der Delegat, der die Vergleiche durchführt. Der Rückgabewert ist true, wenn der gerade betrachtete Member den filterCriteria entspricht, andernfalls false.

filterCriteria: Object

Die Suchkriterien, die bestimmen, ob ein Member im Array von MemberInfo-Objekten zurückgegeben wird.

Die Felder von FieldAttributes, MethodAttributes und MethodImplAttributes können zusammen mit dem FilterAttribute-Delegaten dieser Klasse verwendet werden.

Gibt zurück

MemberInfo[]

Ein gefiltertes Array von MemberInfo-Objekten vom angegebenen Membertyp.

- oder -

Ein leeres Array, wenn der aktuelle Type keine den Filterkriterien entsprechenden Member vom memberType-Typ besitzt.

Implementiert

FindMembers(MemberTypes, BindingFlags, MemberFilter, Object)

Ausnahmen

ArgumentNullException

filter ist null.

Beispiele

Im folgenden Beispiel werden alle Member in einer Klasse gefunden, die den angegebenen Suchkriterien entsprechen, und dann werden die übereinstimmend zugeordneten Member angezeigt.

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();
}
/* The example produces the following output:

Result of FindMembers - Boolean ReferenceEquals(System.Object, System.Object)
*/

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;
    }
}
/* The example produces the following output:

Result of FindMembers - Boolean ReferenceEquals(System.Object, System.Object)
*/

open System.Reflection

let delegateToSearchCriteria (objMemberInfo: MemberInfo) (objSearch: obj) =
    // Compare the name of the member function with the filter criteria.
    string objMemberInfo.Name = string objSearch

let objTest = obj ()
let objType = objTest.GetType ()
try
    //Find all static or public methods in the Object class that match the specified name.
    let arrayMemberInfo = 
        objType.FindMembers(MemberTypes.Method, BindingFlags.Public ||| BindingFlags.Static ||| BindingFlags.Instance, MemberFilter delegateToSearchCriteria, "ReferenceEquals")

    for info in arrayMemberInfo do
        printfn $"Result of FindMembers -\t{info}\n"
with e ->
    printfn $"Exception : {e}"

(* The example produces the following output:

Result of FindMembers - Boolean ReferenceEquals(System.Object, System.Object)
*)


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
' The example produces the following output:
'
' Result of FindMembers - Boolean ReferenceEquals(System.Object, System.Object)

Hinweise

Diese Methode kann von einer abgeleiteten Klasse überschrieben werden.

Member umfassen Eigenschaften, Methoden, Felder, Ereignisse usw.

Damit die FindMembers -Methode Memberinformationen erfolgreich abrufen kann, muss das bindingAttr Argument mindestens eine von BindingFlags.Instance und BindingFlags.Staticenthalten, zusammen mit mindestens einer von BindingFlags.NonPublic und BindingFlags.Public.

Die folgenden BindingFlags Filterflags können verwendet werden, um zu definieren, welche Member in die Suche einbezogen werden sollen:

Geben Sie BindingFlags.Instance an, instance Member in die Suche einzubeziehen.
Geben Sie BindingFlags.Static an, dass statische Member in die Suche eingeschlossen werden sollen.
Geben Sie an BindingFlags.Public , dass öffentliche Member in die Suche einbezogen werden sollen.
Geben Sie an BindingFlags.NonPublic , dass nicht öffentliche Mitglieder (d. h. private, interne und geschützte Member) in die Suche einbezogen werden sollen.

Die folgenden BindingFlags Modifiziererflags können verwendet werden, um die Funktionsweise der Suche zu ändern:

BindingFlags.DeclaredOnly , um nur die elemente zu durchsuchen, die Typefür deklariert sind, und nicht die Elemente, die einfach geerbt wurden.

Weitere Informationen finden Sie unter System.Reflection.BindingFlags.

Um den Klasseninitialisierer (statischer Konstruktor) mithilfe dieser Methode abzurufen, müssen Sie (OrBindingFlags.NonPublic BindingFlags.Static in Visual Basic) angeben.BindingFlags.Static | BindingFlags.NonPublic Sie können den Klasseninitialisierer auch mithilfe der TypeInitializer -Eigenschaft abrufen.

Wenn der aktuelle Type einen Typparameter eines generischen Typs oder einer generischen Methode darstellt, FindMembers verarbeitet alle Durch die Klasseneinschränkung deklarierten Member und die Schnittstelleneinschränkungen des Typparameters.

Bei dem filter Argument kann es sich um einen benutzerdefinierten Delegaten vom Typ MemberFilteroder um einen der folgenden vordefinierten Delegaten handeln:

Type.FilterAttribute, die eineFieldAttributes , MethodAttributesoder MethodImplAttributes Bitmaske als filterCriteria Wert verwendet.
Type.FilterName, bei dem die Groß-/Kleinschreibung der einzelnen Membernamen mit der an filterCriteriaübergebenen Zeichenfolge verglichen wird.
Type.FilterNameIgnoreCase, bei dem die Groß-/Kleinschreibung für jeden Membernamen mit der an filterCriteriaübergebenen Zeichenfolge verglichen wird.

Gilt für:

Freigeben über