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

GenericParameterAttributes énumération

 

Décrit les contraintes sur un paramètre de type générique d’un type ou d’une méthode générique.

Cette énumération possède un attribut FlagsAttribute qui permet une combinaison d’opérations de bits de ses valeurs membres.

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

[FlagsAttribute]
public enum GenericParameterAttributes

Nom du membreDescription
Contravariant

Le paramètre de type générique est contravariant. Un paramètre de type contravariant peut apparaître comme un type de paramètre dans les signatures de méthodes.

Covariant

Le paramètre de type générique est covariant. Un paramètre de type covariant peut apparaître comme le type de résultat d’une méthode, le type d’un champ en lecture seule, un type de base déclaré ou une interface implémentée.

DefaultConstructorConstraint

Un type ne peut venir remplacer le paramètre de type générique que s’il comporte un constructeur sans paramètre.

None

Il n’existe aucun indicateur spécial.

NotNullableValueTypeConstraint

Un type ne peut venir remplacer le paramètre de type générique que s’il s’agit d’un type valeur non Nullable.

ReferenceTypeConstraint

Un type ne peut venir remplacer le paramètre de type générique que s’il s’agit d’un type référence.

SpecialConstraintMask

Sélectionne la combinaison de tous les indicateurs de contrainte spéciaux. Cette valeur est le résultat de l’utilisation du OU logique pour combiner les indicateurs suivants : DefaultConstructorConstraint, ReferenceTypeConstraint et NotNullableValueTypeConstraint.

VarianceMask

Sélectionne la combinaison de tous les indicateurs de variance. Cette valeur est le résultat de l’utilisation du OU logique pour combiner les indicateurs suivants : Contravariant et Covariant.

The members of the T:System.Reflection.GenericParameterAttributes enumeration are divided into two groups, the variance group and the special constraints group. To test a T:System.Reflection.GenericParameterAttributes value for variance flags, first perform a bitwise AND operation with F:System.Reflection.GenericParameterAttributes.VarianceMask. If the result is F:System.Reflection.GenericParameterAttributes.None, there are no variance flags. Similarly, use F:System.Reflection.GenericParameterAttributes.SpecialConstraintMask to test for constraint flags.

The following code example defines a generic type Test with two type parameters. The second type parameter has a base class constraint and a reference type constraint. When the program executes, the constraints are examined using the P:System.Type.GenericParameterAttributes property and the M:System.Type.GetGenericParameterConstraints method.

using System;
using System.Reflection;

// Define a sample interface to use as an interface constraint.
public interface ITest {}

// Define a base type to use as a base class constraint.
public class Base {}

// Define the generic type to examine. The first generic type parameter,
// T, derives from the class Base and implements ITest. This demonstrates
// a base class constraint and an interface constraint. The second generic 
// type parameter, U, must be a reference type (class) and must have a 
// default constructor (new()). This demonstrates special constraints.
//
public class Test<T,U> 
    where T : Base, ITest 
    where U : class, new() {}

// Define a type that derives from Base and implements ITest. This type
// satisfies the constraints on T in class Test.
public class Derived : Base, ITest {}

public class Example
{
    public static void Main()
    {
        // To get the generic type definition, omit the type
        // arguments but retain the comma to indicate the number
        // of type arguments. 
        //
        Type def = typeof(Test<,>);
        Console.WriteLine("\r\nExamining generic type {0}", def);

        // Get the type parameters of the generic type definition,
        // and display them.
        //
        Type[] defparams = def.GetGenericArguments();
        foreach (Type tp in defparams)
        {
            Console.WriteLine("\r\nType parameter: {0}", tp.Name);
            Console.WriteLine("\t{0}", 
                ListGenericParameterAttributes(tp));

            // List the base class and interface constraints. The
            // constraints are returned in no particular order. If 
            // there are no class or interface constraints, an empty
            // array is returned.
            //
            Type[] tpConstraints = tp.GetGenericParameterConstraints();
            foreach (Type tpc in tpConstraints)
            {
                Console.WriteLine("\t{0}", tpc);
            }
        }
    }

    // List the variance and special constraint flags. 
    //
    private static string ListGenericParameterAttributes(Type t)
    {
        string retval;
        GenericParameterAttributes gpa = t.GenericParameterAttributes;
        GenericParameterAttributes variance = gpa & 
            GenericParameterAttributes.VarianceMask;

        // Select the variance flags.
        if (variance == GenericParameterAttributes.None)
            retval = "No variance flag;";
        else
        {
            if ((variance & GenericParameterAttributes.Covariant) != 0)
                retval = "Covariant;";
            else
                retval = "Contravariant;";
        }

        // Select 
        GenericParameterAttributes constraints = gpa & 
            GenericParameterAttributes.SpecialConstraintMask;

        if (constraints == GenericParameterAttributes.None)
            retval += " No special constraints";
        else
        {
            if ((constraints & GenericParameterAttributes.ReferenceTypeConstraint) != 0)
                retval += " ReferenceTypeConstraint";
            if ((constraints & GenericParameterAttributes.NotNullableValueTypeConstraint) != 0)
                retval += " NotNullableValueTypeConstraint";
            if ((constraints & GenericParameterAttributes.DefaultConstructorConstraint) != 0)
                retval += " DefaultConstructorConstraint";
        }

        return retval;
    }
}
/* This example produces the following output:

Examining generic type Test`2[T,U]

Type parameter: T
        No variance flag; no special constraints.
        Base
        ITest

Type parameter: U
        No variance flag; ReferenceTypeConstraint DefaultConstructorConstraint
 */

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 2.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: