GetCustomAttributes Méthode (Assembly, Type, Boolean)
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Attribute.GetCustomAttributes, méthode (Assembly, Type, Boolean)

 

Récupère le tableau des attributs personnalisés appliqué à un assembly.Les paramètres spécifient l'assembly, le type de l'attribut personnalisé à rechercher, et une option de recherche ignorée.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

public static Attribute[] GetCustomAttributes(
	Assembly element,
	Type attributeType,
	bool inherit
)

Paramètres

element

Objet dérivé de la classe Assembly qui décrit une collection de modules réutilisable.

attributeType

Type ou type de base de l'attribut personnalisé à rechercher.

inherit

Ce paramètre est ignoré, mais cela n'affecte pas le fonctionnement de cette méthode.

Valeur de retour

Type: System.Attribute[]

Tableau Attribute qui contient les attributs personnalisés de type attributeType appliqués à element, ou tableau vide en l'absence de tels attributs personnalisés.

Exception Condition
ArgumentNullException

element ou attributeType est null.

ArgumentException

attributeType n'est pas dérivé de Attribute.

System_CAPS_noteRemarque

À partir du .NET Framework version 2.0, cette méthode retourne les attributs de sécurité si les attributs sont stockés dans le nouveau format de métadonnées.Les assemblys compilés avec la version 2.0 ou ultérieure utilisent le nouveau format.Les assemblys dynamiques et les assemblys compilés dans des versions précédentes du .NET Framework utilisent l'ancien format XML.Consultez Emitting Declarative Security Attributes.

L'exemple de code suivant illustre l'utilisation de GetCustomAttributes, avec Assembly comme paramètre.

using System;
using System.Reflection;

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

namespace CustAttrs1CS {
    class DemoClass {
        static void Main(string[] args) {
            Type clsType = typeof(DemoClass);
            // Get the Assembly type to access its metadata.
            Assembly assy = clsType.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);
            }
        }
    }
}

/*
 * Output:
 * Assembly company is Microsoft.
 * Assembly description is "GetCustomAttributes() Demo".
 * Assembly title is "CustAttrs1CS".
 */

.NET Framework
Disponible depuis 1.1
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Retour au début
Afficher:
© 2016 Microsoft