Type.GetMembers Methode
Definition
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.
Ruft die Member (Eigenschaften, Methoden, Felder, Ereignisse usw.) des aktuellen Type ab.
Überlädt
GetMembers() |
Gibt sämtliche öffentlichen Member des aktuellen Type zurück. |
GetMembers(BindingFlags) |
Sucht beim Überschreiben in einer abgeleiteten Klasse unter Verwendung der angegebenen Bindungseinschränkungen die für den aktuellen Type definierten Member. |
GetMembers()
Gibt sämtliche öffentlichen Member des aktuellen Type zurück.
public:
cli::array <System::Reflection::MemberInfo ^> ^ GetMembers();
public:
virtual cli::array <System::Reflection::MemberInfo ^> ^ GetMembers();
public System.Reflection.MemberInfo[] GetMembers ();
member this.GetMembers : unit -> System.Reflection.MemberInfo[]
abstract member GetMembers : unit -> System.Reflection.MemberInfo[]
override this.GetMembers : unit -> System.Reflection.MemberInfo[]
Public Function GetMembers () As MemberInfo()
Gibt zurück
Ein Array von MemberInfo-Objekten, die sämtliche öffentlichen Member des aktuellen Type darstellen.
- oder - Ein leeres Array vom MemberInfo-Typ, wenn der aktuelle Type keine Standardmember besitzt.
Implementiert
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie die GetMembers() Methodenüberladung verwenden, um Informationen zu allen öffentlichen Mitgliedern einer angegebenen Klasse zu sammeln.
ref class MyClass
{
public:
int myInt;
String^ myString;
MyClass(){}
void Myfunction(){}
};
int main()
{
try
{
MyClass^ myObject = gcnew MyClass;
array<MemberInfo^>^myMemberInfo;
// Get the type of 'MyClass'.
Type^ myType = myObject->GetType();
// Get the information related to all public members 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 : {0}", e->Message );
}
}
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
Hinweise
Elemente umfassen Eigenschaften, Methoden, Konstruktoren, Felder, Ereignisse und geschachtelte Typen.
Die GetMembers Methode gibt keine Elemente in einer bestimmten Reihenfolge zurück, z. B. alphabetisch oder Deklarationsreihenfolge. Ihr Code darf nicht von der Reihenfolge abhängig sein, in der Mitglieder zurückgegeben werden, da diese Reihenfolge variiert.
Diese Methodenüberladung ruft die GetMembers(BindingFlags) Methodenüberladung mit BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static (BindingFlags.StaticBindingFlags.PublicOr
BindingFlags.InstanceOr
in Visual Basic) auf. Es wird keine Klassen initializer (statische Konstruktoren) gefunden. Um Klasseninitializer zu finden, rufen Sie die GetMembers(BindingFlags) Überladung auf, und geben BindingFlags.Static Sie | BindingFlags.NonPublic an (BindingFlags.StaticOr
BindingFlags.NonPublic in Visual Basic). Sie können auch den Klassen initializer mithilfe der TypeInitializer Eigenschaft abrufen.
In der folgenden Tabelle wird gezeigt, welche Elemente einer Basisklasse durch die Get
Methoden zurückgegeben werden, wenn sie einen Typ widerspiegeln.
Memberart | statischen | Nicht statischer |
---|---|---|
Konstruktor | Nein | Nein |
Feld | Nein | Ja. Ein Feld ist immer ausgeblendet nach Name und Signatur. |
Ereignis | Nicht zutreffend | Die allgemeine Typsystemregel besteht darin, dass die Vererbung identisch mit den Methoden ist, die die Eigenschaft implementieren. Die Spiegelung behandelt Eigenschaften als Ausblenden nach Name und Signatur. Siehe Hinweis 2 unten. |
Methode | Nein | Ja. Eine Methode (sowohl virtuelle als auch nicht virtuelle) kann nach Name oder Ausblenden nach Name und Signatur ausgeblendet werden. |
Geschachtelter Typ | Nein | Nein |
Eigenschaft | Nicht zutreffend | Die allgemeine Typsystemregel besteht darin, dass die Vererbung identisch mit den Methoden ist, die die Eigenschaft implementieren. Die Spiegelung behandelt Eigenschaften als Ausblenden nach Name und Signatur. Siehe Hinweis 2 unten. |
Hide-by-name-and-signature betrachtet alle Teile der Signatur, einschließlich benutzerdefinierter Modifizierer, Rückgabetypen, Parametertypen, Sentinels und nicht verwaltete Aufrufkonventionen. Dies ist ein binärer Vergleich.
Für die Spiegelung werden Eigenschaften und Ereignisse nach Name und Signatur ausgeblendet. Wenn Sie über eine Eigenschaft mit einem Get- und einem Set-Accessor in der Basisklasse verfügen, aber die abgeleitete Klasse nur einen Get-Accessor hat, blendet die abgeleitete Klasseneigenschaft die Basisklasse-Eigenschaft aus, und Sie können nicht auf den Setter auf die Basisklasse zugreifen.
Benutzerdefinierte Attribute sind nicht Teil des allgemeinen Typsystems.
Wenn der Aktuelle Type einen konstruierten generischen Typ darstellt, gibt diese Methode die MemberInfo Objekte mit den Typparametern zurück, die durch die entsprechenden Typargumente ersetzt werden.
Wenn der Aktuelle Type einen Typparameter in der Definition eines generischen Typs oder einer generischen Methode darstellt, durchsucht diese Methode die Elemente der Klasseneinschränkung oder die Elemente Object der Klasse, wenn keine Klasseneinschränkung vorhanden ist.
Siehe auch
- MemberInfo
- GetMember(String)
- GetDefaultMembers()
- FindMembers(MemberTypes, BindingFlags, MemberFilter, Object)
Gilt für:
GetMembers(BindingFlags)
Sucht beim Überschreiben in einer abgeleiteten Klasse unter Verwendung der angegebenen Bindungseinschränkungen die für den aktuellen Type definierten Member.
public:
abstract cli::array <System::Reflection::MemberInfo ^> ^ GetMembers(System::Reflection::BindingFlags bindingAttr);
public abstract System.Reflection.MemberInfo[] GetMembers (System.Reflection.BindingFlags bindingAttr);
abstract member GetMembers : System.Reflection.BindingFlags -> System.Reflection.MemberInfo[]
Public MustOverride Function GetMembers (bindingAttr As BindingFlags) As MemberInfo()
Parameter
- bindingAttr
- BindingFlags
Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird.
- oder - Default, um ein leeres Array zurückzugeben.
Gibt zurück
Ein Array von MemberInfo-Objekten, die sämtliche für den aktuellen Type definierten öffentlichen Member darstellen, die den angegebenen Bindungseinschränkungen entsprechen.
- oder - Ein leeres Array, wenn für den aktuellen Type keine Member definiert sind oder keiner der definierten Member den Bindungseinschränkungen entspricht.
Implementiert
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie die GetMembers(BindingFlags) Methodenüberladung verwenden, um Informationen über alle elemente der öffentlichen Instanz einer angegebenen Klasse zu sammeln.
ref class MyClass
{
public:
int * myInt;
String^ myString;
MyClass(){}
void Myfunction(){}
};
int main()
{
try
{
MyClass^ MyObject = gcnew MyClass;
array<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( static_cast<BindingFlags>(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 : {0}", 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 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
Hinweise
Elemente umfassen Eigenschaften, Methoden, Konstruktoren, Felder, Ereignisse und geschachtelte Typen.
Für die GetMethods(BindingFlags)
Überladung zum erfolgreichen Abrufen von Methodeninformationen muss das bindingAttr
Argument mindestens eine von BindingFlags.Instance und BindingFlags.Static, zusammen mit mindestens einer von BindingFlags.NonPublic und BindingFlags.Public. Die einzige Ausnahme ist ein Methodenaufruf mit , mit BindingFlags.NonPublicdem Memberinformationen zu geschachtelten Typen zurückgegeben werden.
Die folgenden BindingFlags Filter-Flags können verwendet werden, um zu definieren, welche Elemente in die Suche einbezogen werden sollen:
Geben Sie an
BindingFlags.Instance
, um Instanzmethoden einzuschließen.Geben Sie an
BindingFlags.Static
, statische Methoden einzuschließen.Geben Sie an
BindingFlags.Public
, öffentliche Methoden in die Suche einzuschließen.Geben Sie an
BindingFlags.NonPublic
, nicht öffentliche Methoden (z. B. private, interne und geschützte Methoden) in die Suche einzuschließen. Nur geschützte und interne Methoden für Basisklassen werden zurückgegeben; Private Methoden für Basisklassen werden nicht zurückgegeben.Geben Sie an
BindingFlags.FlattenHierarchy
, wie Sie die Hierarchie einschließen undprotected
statische Elemente einbeziehenpublic
möchten;private
statische Elemente in geerbten Klassen sind nicht enthalten.Geben Sie allein ein leeres
BindingFlags.Default
MethodInfo Array zurück.
Die folgenden BindingFlags Modifizierer-Flags können verwendet werden, um zu ändern, wie die Suche funktioniert:
BindingFlags.DeclaredOnly
um nur die mitglieder zu durchsuchen, die auf der Type, nicht mitglieder, die einfach geerbt wurden.
Weitere Informationen finden Sie unter System.Reflection.BindingFlags.
Die GetMembers Methode gibt keine Elemente in einer bestimmten Reihenfolge zurück, z. B. alphabetisch oder Deklarationsreihenfolge. Ihr Code darf nicht von der Reihenfolge abhängig sein, in der Mitglieder zurückgegeben werden, da diese Reihenfolge variiert.
Um den Klassen initializer (statischer Konstruktor) mithilfe dieser Methodenüberladung abzurufen, müssen Sie | BindingFlags.NonPublic (BindingFlags.StaticOr
BindingFlags.NonPublic in Visual Basic) angeben.BindingFlags.Static Sie können auch den Klassen initializer mithilfe der TypeInitializer Eigenschaft abrufen.
Wenn der Aktuelle Type einen konstruierten generischen Typ darstellt, gibt diese Methode die MemberInfo Objekte mit den Typparametern zurück, die durch die entsprechenden Typargumente ersetzt werden.
Wenn der Aktuelle Type einen Typparameter in der Definition eines generischen Typs oder einer generischen Methode darstellt, durchsucht diese Methode die Elemente der Klasseneinschränkung oder die Elemente Object der Klasse, wenn keine Klasseneinschränkung vorhanden ist.
Siehe auch
- MemberInfo
- BindingFlags
- DefaultBinder
- GetMember(String)
- GetDefaultMembers()
- FindMembers(MemberTypes, BindingFlags, MemberFilter, Object)