GenericParameterAttributes Enumeration

Definition

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Beschreibt die Einschränkungen für einen generischen Typparameter eines generischen Typs oder einer generischen Methode.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

C#

[System.Flags]
public enum GenericParameterAttributes

Vererbung

Object

ValueType

Enum

GenericParameterAttributes

Attribute

FlagsAttribute

Felder

Name	Wert	Beschreibung
Contravariant	2	Der generische Typparameter ist kontravariant. Ein kontravarianter Typparameter kann als Parametertyp in Methodensignaturen angezeigt werden.
Covariant	1	Der generische Typparameter ist kovariant. Ein kovarianter Typparameter kann als Ergebnistyp einer Methode, dem Typ eines schreibgeschützten Felds, eines deklarierten Basistyps oder einer implementierten Schnittstelle angezeigt werden.
DefaultConstructorConstraint	16	Ein Typ kann nur durch den generischen Typparameter ersetzt werden, wenn er über einen parameterlosen Konstruktor verfügt.
None	0	Es gibt keine speziellen Kennzeichnungen.
NotNullableValueTypeConstraint	8	Ein Typ kann nur durch den generischen Typparameter ersetzt werden, wenn es sich um einen Werttyp handelt und nicht nullwertebar ist.
ReferenceTypeConstraint	4	Ein Typ kann nur durch den generischen Typparameter ersetzt werden, wenn es sich um einen Verweistyp handelt.
SpecialConstraintMask	28	Wählt die Kombination aller speziellen Einschränkungskennzeichnungen aus. Dieser Wert ist das Ergebnis der Verwendung logischer OR-Kennzeichnungen: DefaultConstructorConstraint, ReferenceTypeConstraintund NotNullableValueTypeConstraint.
VarianceMask	3	Wählt die Kombination aller Varianzkennzeichnungen aus. Dieser Wert ist das Ergebnis der Verwendung logischer OR-Kennzeichnungen, um die folgenden Flags zu kombinieren: Contravariant und Covariant.

Beispiele

Im folgenden Codebeispiel wird ein generischer Typ Test mit zwei Typparametern definiert. Der zweite Typparameter verfügt über eine Basisklasseneinschränkung und eine Verweistypeinschränkung. Wenn das Programm ausgeführt wird, werden die Einschränkungen mithilfe der Type.GenericParameterAttributes-Eigenschaft und der Type.GetGenericParameterConstraints-Methode untersucht.

C#

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

Hinweise

Die Mitglieder der GenericParameterAttributes Enumeration sind in zwei Gruppen unterteilt, die Varianzgruppe und die spezielle Einschränkungsgruppe. Um einen GenericParameterAttributes Wert für Varianzkennzeichnungen zu testen, führen Sie zunächst einen bitweisen AND-Vorgang mit VarianceMask aus. Wenn das Ergebnis "Keine" lautet, gibt es keine Varianzkennzeichnungen. Ebenso verwenden Sie SpecialConstraintMask, um auf Einschränkungskennzeichnungen zu testen.

Gilt für: