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

 

Veröffentlicht: Oktober 2016

Ruft ein Array der benutzerdefinierten Attribute angewendet, die auf einen Member eines Typs ab. 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[] GetCustomAttributes(
	MemberInfo element,
	Type type,
	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.

type
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 Attribute Array, das die benutzerdefinierten Attribute des Typs enthält type angewendet element, oder ein leeres Array, wenn keine solchen benutzerdefinierten Attribute vorhanden sind.

Exception Condition
ArgumentNullException

element oder type ist null.

ArgumentException

typestammt nicht aus Attribute.

NotSupportedException

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

TypeLoadException

Ein benutzerdefinierter Attributtyp kann nicht geladen werden.

Der Rückgabewert enthält die benutzerdefinierten Attribute für frühere Versionen von element Wenn inherit ist true.

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 GetCustomAttributesunter Berücksichtigung einer MemberInfo als Parameter.

using System;
using System.Reflection;
using System.Security;
using System.Runtime.InteropServices;

namespace CustAttrs4CS
{

    // Define an enumeration of Win32 unmanaged types
    public enum UnmanagedType
    {
        User,
        GDI,
        Kernel,
        Shell,
        Networking,
        Multimedia
    }

    // Define the Unmanaged attribute.
    public class UnmanagedAttribute : Attribute
    {
        // Storage for the UnmanagedType value.
        protected UnmanagedType thisType;

        // Set the unmanaged type in the constructor.
        public UnmanagedAttribute(UnmanagedType type)
        {
            thisType = type;
        }

        // Define a property to get and set the UnmanagedType value.
        public UnmanagedType Win32Type
        {
            get { return thisType; }
            set { thisType = Win32Type; }
        }
    }

    // Create a class for an imported Win32 unmanaged function.
    public class Win32 {
        [DllImport("user32.dll", CharSet = CharSet.Unicode)]
        public static extern int MessageBox(int hWnd, String text,
            String caption, uint type);
    }

    public class AClass {
        // Add some attributes to Win32CallMethod.
        [Obsolete("This method is obsolete. Use managed MsgBox instead.")]
        [Unmanaged(UnmanagedType.User)]
        public void Win32CallMethod()
        {
            Win32.MessageBox(0, "This is an unmanaged call.", "Caution!", 0);
        }
    }

    class DemoClass {
        static void Main(string[] args)
            {
            // Get the AClass type to access its metadata.
            Type clsType = typeof(AClass);
            // Get the type information for Win32CallMethod.
            MethodInfo mInfo = clsType.GetMethod("Win32CallMethod");
            if (mInfo != null)
            {
                // Iterate through all the attributes of the method.
                foreach(Attribute attr in
                    Attribute.GetCustomAttributes(mInfo)) {
                    // Check for the Obsolete attribute.
                    if (attr.GetType() == typeof(ObsoleteAttribute))
                    {
                        Console.WriteLine("Method {0} is obsolete. " +
                            "The message is:",
                            mInfo.Name);
                        Console.WriteLine("  \"{0}\"",
                            ((ObsoleteAttribute)attr).Message);
                    }

                    // Check for the Unmanaged attribute.
                    else if (attr.GetType() == typeof(UnmanagedAttribute))
                    {
                        Console.WriteLine(
                            "This method calls unmanaged code.");
                        Console.WriteLine(
                            String.Format("The Unmanaged attribute type is {0}.",
                                          ((UnmanagedAttribute)attr).Win32Type));
                        AClass myCls = new AClass();
                        myCls.Win32CallMethod();
                    }
                }
            }
        }
    }
}

/*

This code example produces the following results.

First, the compilation yields the warning, "...This method is
obsolete. Use managed MsgBox instead."
Second, execution yields a message box with a title of "Caution!"
and message text of "This is an unmanaged call."
Third, the following text is displayed in the console window:

Method Win32CallMethod is obsolete. The message is:
  "This method is obsolete. Use managed MsgBox instead."
This method calls unmanaged code.
The Unmanaged attribute type is User.

*/

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