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: (Assembly, Type)

 

Veröffentlicht: Oktober 2016

Ruft ein benutzerdefiniertes Attribut auf eine bestimmte Assembly angewendet. Parameter geben die Assembly und den Typ des benutzerdefinierten Attributs zu suchen.

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

public static Attribute GetCustomAttribute(
	Assembly element,
	Type attributeType
)

Parameter

element
Type: System.Reflection.Assembly

Ein Objekt, das aus der Assembly-Klasse abgeleitet wurde, die eine wiederverwendbare Auflistung von Modulen 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.

AmbiguousMatchException

Mehr als eine der erforderlichen Attribute wurde gefunden.

Verwenden der GetCustomAttributes Methode, wenn Sie erwarten, dass mehrere Werte zurückgegeben werden, oder AmbiguousMatchException ausgelöst.

System_CAPS_noteHinweis

Ab .NET Framework, Version 2.0, gibt diese Methode Sicherheitsattribute aus, 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 Assembly als Parameter.

using System;
using System.Reflection;

// Add an AssemblyDescription attribute
[assembly: AssemblyDescription("A sample description")]
namespace IsDef1CS
{
    public class DemoClass
    {
        static void Main(string[] args)
        {
            // Get the class type to access its metadata.
            Type clsType = typeof(DemoClass);
            // Get the assembly object.
            Assembly assy = clsType.Assembly;
            // Store the assembly's name.
            String assyName = assy.GetName().Name;
            // See if the Assembly Description is defined.
            bool isdef = Attribute.IsDefined(assy, 
                typeof(AssemblyDescriptionAttribute));
            if (isdef)
            {
                // Affirm that the attribute is defined.
                Console.WriteLine("The AssemblyDescription attribute " +
                    "is defined for assembly {0}.", assyName);
                // Get the description attribute itself.
                AssemblyDescriptionAttribute adAttr = 
                    (AssemblyDescriptionAttribute)Attribute.GetCustomAttribute(
                    assy, typeof(AssemblyDescriptionAttribute));
                // Display the description.
                if (adAttr != null)
                    Console.WriteLine("The description is \"{0}\".", 
                        adAttr.Description);
                else
                    Console.WriteLine("The description could not " +
                        "be retrieved.");            
            }
            else
                Console.WriteLine("The AssemblyDescription attribute is not " +
                    "defined for assembly {0}.", assyName);
        }
    }
}

/*
 * Output:
 * The AssemblyDescription attribute is defined for assembly IsDef1CS.
 * The description is "A sample description".
 */

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