Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

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 la combinaison d'opérations de bits de ses valeurs de membres.

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

[FlagsAttribute]
public enum GenericParameterAttributes

Nom de membreDescription
Pris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreContravariantLe paramètre de type générique est contravariant. Un paramètre de type contravariant peut apparaître comme type de paramètre dans les signatures de méthode.
Pris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCovariantLe paramètre de type générique est covariant. Un paramètre de type covariant peut apparaître comme type de résultat d'une méthode, type d'un champ en lecture seule, type de base déclaré ou interface implémentée.
Pris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDefaultConstructorConstraintUn type ne peut être substitué au paramètre de type générique que s'il possède un constructeur sans paramètre.
Pris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNoneIl n'existe aucun indicateur spécial.
Pris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNotNullableValueTypeConstraintUn type ne peut être substitué au paramètre de type générique que s'il s'agit d'un type valeur et s'il n'est pas nullable.
Pris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreReferenceTypeConstraintUn type ne peut être substitué au paramètre de type générique que s'il s'agit d'un type référence.
Pris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreSpecialConstraintMaskSélectionne la combinaison de tous les indicateurs de contrainte spéciaux. Cette valeur est le résultat de l'utilisation de l'opérateur OR logique pour combiner les indicateurs suivants : DefaultConstructorConstraint, ReferenceTypeConstraint et NotNullableValueTypeConstraint.
Pris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreVarianceMaskSélectionne la combinaison de tous les indicateurs de variance. Cette valeur est le résultat de l'utilisation de l'opérateur OR logique pour combiner les indicateurs suivants : Contravariant et Covariant.

Les membres de l'énumération GenericParameterAttributes sont répartis en deux groupes : le groupe des variances et le groupe des contraintes spéciales. Pour tester une valeur GenericParameterAttributes pour des indicateurs de variance, exécutez d'abord une opération de bits AND avec VarianceMask. Si le résultat est None, il n'existe pas d'indicateur de variance. De même, utilisez SpecialConstraintMask pour tester les indicateurs de contrainte.

L'exemple de code suivant définit un type générique Test avec deux paramètres de type. Le deuxième paramètre de type possède une contrainte de classe de base et une contrainte de type référence. Lorsque le programme s'exécute, les contraintes sont examinées à l'aide de la propriété Type.GenericParameterAttributes et de la méthode Type.GetGenericParameterConstraints.


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
 */


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft