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

Type.GetProperty méthode (String, Type, Type[], ParameterModifier[])

 

Date de publication : novembre 2016

Recherche la propriété publique spécifiée dont les paramètres correspondent aux types d'arguments et modificateurs spécifiés.

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

public PropertyInfo GetProperty(
	string name,
	Type returnType,
	Type[] types,
	ParameterModifier[] modifiers
)

Paramètres

name
Type: System.String

Chaîne contenant le nom de la propriété publique à obtenir.

returnType
Type: System.Type

Type de retour de la propriété.

types
Type: System.Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la propriété indexée à obtenir.

ou

Tableau vide du type Type (c'est-à-dire Type[] types = new Type[0]) pour obtenir une propriété qui n'est pas indexée.

modifiers
Type: System.Reflection.ParameterModifier[]

Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. Le binder par défaut ne traite pas ce paramètre.

Valeur de retour

Type: System.Reflection.PropertyInfo

Objet qui représente la propriété publique correspondant aux critères spécifiés, si elle est trouvée ; sinon, null.

Exception Condition
AmbiguousMatchException

Au moins deux propriétés portent le nom spécifié et correspondent aux types et modificateurs d’arguments spécifiés.

ArgumentNullException

name a la valeur null.

ou

types a la valeur null.

ArgumentException

types est multidimensionnel.

ou

modifiers est multidimensionnel.

ou

types et modifiers n’ont pas la même longueur.

NullReferenceException

Un élément de types est null.

Une propriété est considérée comme publique de la réflexion s’il a au moins un accesseur est public. Sinon, la propriété est considérée comme privée, et vous devez utiliser BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (en Visual Basic, combinez les valeurs à l’aide de Or) pour l’obtenir.

Bien que le binder par défaut ne traite pas ParameterModifier (le modifiers paramètre), vous pouvez utiliser le résumé System.Reflection.Binder classe permettant d’écrire un binder personnalisé qui traite modifiers. ParameterModifierest utilisé uniquement lors de l’appel via COM interop, et seuls les paramètres qui sont passés par référence sont gérées.

La recherche de name respecte la casse. La recherche inclut les propriétés d’instance public de static et public.

Si le courant Type représente un type générique construit, cette méthode retourne la PropertyInfo avec les paramètres de type remplacés par les arguments de type approprié.

Si le courant Type représente un paramètre de type dans la définition d’un type générique ou de méthode générique, cette méthode recherche les propriétés de la contrainte de classe.

Visual Basic 2005, Visual C# 2005, et Visual C++ 2005 ont une syntaxe simplifiée pour accéder aux propriétés indexées et permettent à une propriété indexée comme une valeur par défaut pour son type. Par exemple, si la variable myList fait référence à un ArrayList, la syntaxe myList[3] (myList(3) en Visual Basic) récupère l’élément avec l’index 3. Vous pouvez surcharger la propriété.

En c#, cette fonctionnalité est appelée un indexeur et ne peut pas être référencée par nom. Par défaut, un indexeur c# apparaît dans les métadonnées comme une propriété indexée nommée « Item ». Toutefois, un développeur de bibliothèque de classes peut utiliser le IndexerNameAttribute attribut pour modifier le nom de l’indexeur dans les métadonnées. Par exemple, le String classe a un indexeur nommé Chars. Les propriétés indexées créées à l’aide des langages autres que c# peuvent avoir des noms autres que de l’élément, également. 

Pour déterminer si un type a une propriété par défaut, utilisez le GetCustomAttributes(Type, Boolean) méthode pour tester le DefaultMemberAttribute attribut. Si le type a DefaultMemberAttribute, le MemberName propriété retourne le nom de la propriété par défaut.

L’exemple suivant obtient un Type objet correspondant à MyPropertyClass, et la propriété indexée de cette classe est récupérée à l’aide des arguments passés à la GetProperty (méthode).

using System;
using System.Reflection;
public class MyPropertyClass
{
    private int [,] myPropertyArray = new int[10,10]; 
    // Declare an indexer.
    public int this [int i,int j]
    {
        get 
        {
            return myPropertyArray[i,j];
        }
        set 
        {
            myPropertyArray[i,j] = value;
        }
    }
}
public class MyTypeClass
{
    public static void Main()
    {
        try
        {
            Type myType=typeof(MyPropertyClass);
            Type[] myTypeArray = new Type[2];
            // Create an instance of the Type array representing the number, order 
            // and type of the parameters for the property.
            myTypeArray.SetValue(typeof(int),0);
            myTypeArray.SetValue(typeof(int),1);
            // Search for the indexed property whose parameters match the
            // specified argument types and modifiers.
            PropertyInfo myPropertyInfo = myType.GetProperty("Item",
                typeof(int),myTypeArray,null);
            Console.WriteLine(myType.FullName + "." + myPropertyInfo.Name + 
                " has a property type of " + myPropertyInfo.PropertyType);
         }
        catch(Exception ex)
        {
            Console.WriteLine("An exception occurred " + ex.Message);
        }
    }
}

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