Exporter (0) Imprimer
Développer tout

Attribute.GetCustomAttributes, méthode (ParameterInfo, Type)

Récupère le tableau des attributs personnalisés appliqué à un paramètre de méthode. Les paramètres spécifient le paramètre de méthode et le type de l'attribut personnalisé à rechercher.

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

public static Attribute[] GetCustomAttributes (
	ParameterInfo element,
	Type attributeType
)
public static Attribute[] GetCustomAttributes (
	ParameterInfo element, 
	Type attributeType
)
public static function GetCustomAttributes (
	element : ParameterInfo, 
	attributeType : Type
) : Attribute[]

Paramètres

element

Objet dérivé de la classe ParameterInfo qui décrit un paramètre d'un membre d'une classe.

attributeType

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

Valeur de retour

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.

Type d'exceptionCondition

ArgumentNullException

element ou attributeType est référence Null (Nothing en Visual Basic).

ArgumentException

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

Si element représente un paramètre dans une méthode d'un type dérivé, la valeur de retour inclut les attributs personnalisés pouvant être hérités qui sont appliqués au même paramètre dans les méthodes de base substituées.

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

using System;
using System.Reflection;
using System.ComponentModel;

namespace CustAttrs5CS {
    public class AClass {
        public void ParamArrayAndDesc(
            // Add ParamArray (with the keyword) and Description attributes.
            [Description("This argument is a ParamArray")]
            params int[] args)
        {}
    }

    class DemoClass {
        static void Main(string[] args) {
            // Get the Class type to access its metadata.
            Type clsType = typeof(AClass);
            // Get the type information for the method.
            MethodInfo mInfo = clsType.GetMethod("ParamArrayAndDesc");
            if (mInfo != null) {
                // Get the parameter information.
                ParameterInfo[] pInfo = mInfo.GetParameters();
                if (pInfo != null) {
                    // Iterate through all the attributes for the parameter.
                    foreach(Attribute attr in 
                        Attribute.GetCustomAttributes(pInfo[0])) {
                        // Check for the ParamArray attribute.
                        if (attr.GetType() == typeof(ParamArrayAttribute))
                            Console.WriteLine("Parameter {0} for method {1} " +
                                "has the ParamArray attribute.",
                                pInfo[0].Name, mInfo.Name);
                        // Check for the Description attribute.
                        else if (attr.GetType() == 
                            typeof(DescriptionAttribute)) {
                            Console.WriteLine("Parameter {0} for method {1} " +
                                "has a description attribute.",
                                pInfo[0].Name, mInfo.Name);
                            Console.WriteLine("The description is: \"{0}\"",
                                ((DescriptionAttribute)attr).Description);
                        }
                    }
                }
            }
        }
    }
}

/*
 * Output:
 * Parameter args for method ParamArrayAndDesc has a description attribute.
 * The description is: "This argument is a ParamArray"
 * Parameter args for method ParamArrayAndDesc has the ParamArray attribute.
 */

package CustAttrs5JSL; 
import System.*;
import System.Reflection.*;
import System.ComponentModel.*;

public class AClass
{
    public void ParamArrayAndDesc(
        // Add ParamArray (with the keyword) and Description attributes.
        /** @attribute Description("This argument is a ParamArray")
         */
        /** @attribute System.ParamArray() 
         */
        int args[])
    {
    } //ParamArrayAndDesc
} //AClass

class DemoClass
{
    public static void main(String[] args)
    {
        // Get the Class type to access its metadata.
        Type clsType = AClass.class.ToType();

        // Get the type information for the method.
        MethodInfo mInfo = clsType.GetMethod("ParamArrayAndDesc");
        if (mInfo != null) {
            // Get the parameter information.
            ParameterInfo pInfo[] = mInfo.GetParameters();
            if (pInfo != null) {
                // Iterate through all the attributes for the parameter.
                for (int iCtr = 0; iCtr < Attribute.GetCustomAttributes(
                    pInfo[0]).get_Length(); iCtr++) {
                    Attribute attr = (Attribute)Attribute.
                        GetCustomAttributes(pInfo[0]).get_Item(iCtr);
                    // Check for the ParamArray attribute.
                    if (attr.GetType().Equals(ParamArrayAttribute.class.
                        ToType())) {
                        Console.WriteLine("Parameter {0} for method {1} " 
                            + "has the ParamArray attribute.",
                            pInfo[0].get_Name(), mInfo.get_Name());
                    }
                    // Check for the Description attribute.
                    else {
                        if (attr.GetType().Equals(DescriptionAttribute.class.
                            ToType())) {
                            Console.WriteLine("Parameter {0} for method {1} " 
                                + "has a description attribute.", 
                                pInfo[0].get_Name(),mInfo.get_Name());
                            Console.WriteLine("The description is: \"{0}\"",
                                ((DescriptionAttribute)(attr)).
                                get_Description());
                        }
                    }
                }
            }
        }
    } //main
} //DemoClass   

/*
    Output:
    Parameter args for method ParamArrayAndDesc has a description attribute.
    The description is: "This argument is a ParamArray"
    Parameter args for method ParamArrayAndDesc has the ParamArray attribute.
*/

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft