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)

 

Veröffentlicht: Oktober 2016

Ruft ein benutzerdefiniertes Attribut auf einen Member eines Typs angewendet. Parameter geben den Member und den Typ des benutzerdefinierten Attributs zu suchen.

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

public static Attribute GetCustomAttribute(
	MemberInfo element,
	Type attributeType
)

Parameter

element
Type: System.Reflection.MemberInfo

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

attributeType
Type: System.Type

Der Typ oder einen Basistyp des benutzerdefinierten Attributs zu suchen.

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

attributeType stammt nicht von Attribute.

NotSupportedException

element ist ein Konstruktor, Methode, Eigenschaft, Ereignis, Typ oder Feld.

AmbiguousMatchException

Mehr als eine der erforderlichen Attribute wurde gefunden.

TypeLoadException

Ein benutzerdefiniertes Attribut kann nicht geladen werden.

Eine Übereinstimmung wird bestimmt, wie beschrieben im Abschnitt Rückgabewert des Type.IsAssignableFrom.

System_CAPS_noteHinweis

Ab .NET Framework, Version 2.0, gibt diese Methode für Typen, Methoden und Konstruktoren Sicherheitsattribute zurück, wenn die Attribute im neuen Metadatenformat gespeichert sind. Mit Version 2.0 oder höher kompilierte Assemblys verwenden das neue 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.

Das folgende Codebeispiel veranschaulicht die Verwendung der GetCustomAttribute Methode übernehmen eine 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: