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

Attribute.GetCustomAttribute-Methode: (MemberInfo, Type, Boolean)

 

Veröffentlicht: Oktober 2016

Ruft ein benutzerdefiniertes Attribut auf einen Member eines Typs angewendet. Parameter geben den Member, der den Typ des benutzerdefinierten Attributs gesucht und bestimmt, ob die Vorgänger des Elements durchsucht.

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

public static Attribute GetCustomAttribute(
	MemberInfo element,
	Type attributeType,
	bool inherit
)

Parameter

element
Type: System.Reflection.MemberInfo

Ein abgeleitetes Objekt aus der MemberInfo Klasse, die einen Konstruktor, Ereignis, ein Feld, Methode oder Eigenschaft Member einer Klasse beschreibt.

attributeType
Type: System.Type

Der Typ oder ein Basistyp des benutzerdefinierten Attributs gesucht.

inherit
Type: System.Boolean

Wenn true, gibt an, dass auch die Suche die Vorgänger des element für benutzerdefinierte Attribute.

Rückgabewert

Type: System.Attribute

Ein Verweis auf das einzige benutzerdefinierte Attribut vom Typ attributeType angewendeten element, oder null , wenn kein solches Attribut vorhanden ist.

Exception Condition
ArgumentNullException

element oder attributeType ist null.

ArgumentException

attributeTypestammt nicht aus Attribute.

NotSupportedException

elementist Sie nicht, einen Konstruktor, Methoden-, Eigenschafts-, Ereignis, Typ oder Feld.

AmbiguousMatchException

Mehr als eine der erforderlichen Attribute gefunden.

TypeLoadException

Ein benutzerdefinierter Attributtyp kann nicht geladen werden.

System_CAPS_noteHinweis

Beginnend mit .NET Framework, Version 2.0, gibt diese Methode auf Typen, Methoden und Konstruktoren Sicherheitsattribute zurück, wenn die Attribute in das neue Metadatenformat gespeichert werden. Mit Version 2.0 oder höher kompilierte Assemblys verwenden Sie das neue Format. Dynamische Assemblys und Assemblys, die mit früheren Versionen von .NET Framework kompiliert verwenden die alte XML-Format. Finden Sie unter Ausgeben von deklarativen Sicherheitsattribute.

Das folgende Codebeispiel veranschaulicht die Verwendung von der GetCustomAttribute Methode Aufnahme einer MemberInfo als Parameter.

using System;
using System.Reflection;

namespace IsDef4CS 
{
    public class TestClass 
    {
        // Assign the Obsolete attribute to a method.
        [Obsolete("This method is obsolete. Use Method2 instead.")]
        public void Method1()
        {}
        public void Method2()
        {}
    }

    public class DemoClass 
    {
        static void Main(string[] args) 
        {
            // Get the class type to access its metadata.
            Type clsType = typeof(TestClass);
            // Get the MethodInfo object for Method1.
            MethodInfo mInfo = clsType.GetMethod("Method1");
            // See if the Obsolete attribute is defined for this method.
            bool isDef = Attribute.IsDefined(mInfo, typeof(ObsoleteAttribute));
            // Display the result.
            Console.WriteLine("The Obsolete Attribute {0} defined for {1} of class {2}.",
                isDef ? "is" : "is not", mInfo.Name, clsType.Name);
            // If it's defined, display the attribute's message.
            if (isDef) 
            {
                ObsoleteAttribute obsAttr = 
                                 (ObsoleteAttribute)Attribute.GetCustomAttribute( 
                                                    mInfo, typeof(ObsoleteAttribute));
                if (obsAttr != null)
                    Console.WriteLine("The message is: \"{0}\".",
                        obsAttr.Message);
                else
                    Console.WriteLine("The message could not be retrieved.");
            }
        }
    }
}

/*
 * Output:
 * The Obsolete Attribute is defined for Method1 of class TestClass.
 * The message is: "This method is obsolete. Use Method2 instead.".
 */

.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: