Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

MemberInfo.GetCustomAttributes-Methode: (Boolean)

 

Veröffentlicht: Oktober 2016

Ruft beim Überschreiben in einer abgeleiteten Klasse zurückgegeben ein Array aller benutzerdefinierten Attribute, die auf diesen Member angewendet.

Namespace:   System.Reflection
Assembly:  mscorlib (in mscorlib.dll)

public abstract object[] GetCustomAttributes(
	bool inherit
)

Parameter

inherit
Type: System.Boolean

true die Attribute die Vererbungskette dieses Members gesucht werden soll. andernfalls false. Dieser Parameter wird für Eigenschaften und Ereignisse ignoriert. Siehe Hinweise.

Rückgabewert

Type: System.Object[]

Ein Array, das alle auf diesen Member angewendete benutzerdefinierte Attribute enthält, oder ein Array mit 0 (null) Elementen, wenn keine Attribute definiert sind.

Exception Condition
InvalidOperationException

Dieser Member gehört zu einem Typ, der in den ReflectionOnly Kontext geladen wird. Weitere Informationen finden Sie unter Gewusst wie: Laden von Assemblys in den reflektionsbezogenen Kontext.

TypeLoadException

Ein benutzerdefinierter Attributtyp konnte nicht geladen werden.

Diese Methode ignoriert die inherit Parameter für Eigenschaften und Ereignisse. Um die Vererbungskette für Attribute, Eigenschaften und Ereignisse zu suchen, verwenden Sie die entsprechenden Überladungen der Attribute.GetCustomAttributes Methode.

System_CAPS_noteHinweis

   In .NET Framework, Version 2.0 gibt diese Methode Sicherheitsattribute für Methoden, Konstruktoren und Typen zurück, wenn diese im neuen Metadatenformat gespeichert sind. Mit Version 2.0 kompilierte Assemblys verwenden dieses Format. Dynamische Assemblys und mit früheren Versionen von .NET Framework kompilierte Assemblys verwenden das alte XML-Format. Finden Sie unter Ausgeben von deklarativen Sicherheitsattributen.

Im folgenden Beispiel wird ein benutzerdefiniertes Attribut definiert und ordnet das Attribut mit MyClass.MyMethod, das Attribut zur Laufzeit abgerufen und das Ergebnis wird angezeigt.

using System;
using System.Reflection;

// Define a custom attribute with one named parameter.
[AttributeUsage(AttributeTargets.All)]
public class MyAttribute : Attribute
{
    private string myName;
    public MyAttribute(string name)
    {
        myName = name;
    }
    public string Name
    {
        get
        {
            return myName;
        }
    }
}

// Define a class that has the custom attribute associated with one of its members.
public class MyClass1
{
    [MyAttribute("This is an example attribute.")]
    public void MyMethod(int i)
    {
        return;
    }
}

public class MemberInfo_GetCustomAttributes
{
    public static void Main()
    {
        try
        {
            // Get the type of MyClass1.
            Type myType = typeof(MyClass1);
            // Get the members associated with MyClass1.
            MemberInfo[] myMembers = myType.GetMembers();

            // Display the attributes for each of the members of MyClass1.
            for(int i = 0; i < myMembers.Length; i++)
            {
                Object[] myAttributes = myMembers[i].GetCustomAttributes(true);
                if(myAttributes.Length > 0)
                {
                    Console.WriteLine("\nThe attributes for the member {0} are: \n", myMembers[i]);
                    for(int j = 0; j < myAttributes.Length; j++)
                        Console.WriteLine("The type of the attribute is {0}.", myAttributes[j]);
                }
            }
        }
        catch(Exception e)
        {
            Console.WriteLine("An exception occurred: {0}", e.Message);
        }
    }
}

.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Zurück zum Anfang
Anzeigen: