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

 

Veröffentlicht: Oktober 2016

Ruft ein Array der benutzerdefinierten Attribute ab, die auf eine Assembly angewendet werden. Parameter geben die Assembly und den Typ des benutzerdefinierten Attributs gesucht.

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

public static Attribute[] GetCustomAttributes(
	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 ein Basistyp des benutzerdefinierten Attributs gesucht.

Rückgabewert

Type: System.Attribute[]

Ein Attribute Array, das die benutzerdefinierten Attribute des Typs enthält attributeType angewendet element, oder ein leeres Array, wenn keine solchen benutzerdefinierten Attribute vorhanden sind.

Exception Condition
ArgumentNullException

element oder attributeType ist null.

ArgumentException

attributeTypestammt nicht aus Attribute.

System_CAPS_noteHinweis

Beginnend mit .NET Framework, Version 2.0, gibt diese Methode Sicherheitsattribute aus, 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 GetCustomAttributes, wobei ein Assembly als Parameter.

using System;
using System.Reflection;

[assembly: AssemblyTitle("CustAttrs1CS")]
[assembly: AssemblyDescription("GetCustomAttributes() Demo")]
[assembly: AssemblyCompany("Microsoft")]

class Example {
    static void Main() {
        // Get the Assembly object to access its metadata.
        Assembly assy = typeof(Example).Assembly;

        // Iterate through the attributes for the assembly.
        foreach(Attribute attr in Attribute.GetCustomAttributes(assy)) {
            // Check for the AssemblyTitle attribute.
            if (attr.GetType() == typeof(AssemblyTitleAttribute))
                Console.WriteLine("Assembly title is \"{0}\".",
                    ((AssemblyTitleAttribute)attr).Title);

            // Check for the AssemblyDescription attribute.
            else if (attr.GetType() == 
                typeof(AssemblyDescriptionAttribute))
                Console.WriteLine("Assembly description is \"{0}\".",
                    ((AssemblyDescriptionAttribute)attr).Description);

            // Check for the AssemblyCompany attribute.
            else if (attr.GetType() == typeof(AssemblyCompanyAttribute))
                Console.WriteLine("Assembly company is {0}.",
                    ((AssemblyCompanyAttribute)attr).Company);
        }
   }
}
// The example displays the following output:
//     Assembly title is "CustAttrs1CS".
//     Assembly description is "GetCustomAttributes() Demo".
//     Assembly company is Microsoft.

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