(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

GenericParameterAttributes-Enumeration

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

Diese Enumeration verfügt über ein FlagsAttribute-Attribut, das die bitweise Kombination der Memberwerte zulässt.

Namespace:  System.Reflection
Assembly:  mscorlib (in mscorlib.dll)

[FlagsAttribute]
public enum GenericParameterAttributes

MembernameBeschreibung
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsContravariantDer generische Typparameter ist Contravariant. Ein Contravariant-Typparameter kann in Methodensignaturen als Parametertyp aufgeführt werden.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCovariantDer generische Typparameter ist Covariant. Ein Covariant-Typparameter kann als Ergebnistyp einer Methode, als Typ eines schreibgeschützten Felds, als deklarierter Basistyp oder als eine implementierte Schnittstelle verwendet werden.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDefaultConstructorConstraintEin Typ kann nur durch den generischen Typparameter ersetzt werden, wenn er über einen parameterlosen Konstruktor verfügt.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsNoneEs gibt keine besonderen Flags.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsNotNullableValueTypeConstraintEin Typ kann nur durch den generischen Typparameter ersetzt werden, wenn er ein Werttyp ist, für den keine NULL-Werte zulässig sind.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsReferenceTypeConstraintEin Typ kann nur durch den generischen Typparameter ersetzt werden, wenn er ein Verweistyp ist.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsSpecialConstraintMaskWählt die Kombination aller besonderen Einschränkungsflags aus. Dieser Wert entsteht durch Kombination der folgenden Flags mit logischem OR: DefaultConstructorConstraint, ReferenceTypeConstraint und NotNullableValueTypeConstraint.
Unterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsVarianceMaskWählt die Kombination aller Varianzflags aus. Dieser Wert entsteht durch Kombination der folgenden Flags mit logischem OR: Contravariant und Covariant.

Die Member der GenericParameterAttributes-Enumeration werden in zwei Gruppen unterteilt, die Varianzgruppe und die Gruppe mit besonderen Einschränkungen. Um einen GenericParameterAttributes-Wert für Varianzflags zu testen, führen Sie zuerst eine bitweise UND-Operation mit VarianceMask aus. Wenn das Ergebnis None ist, gibt es keine Varianzflags. Entsprechend werden mit SpecialConstraintMask Einschränkungsflags getestet.

Im folgenden Codebeispiel wird der generische Typ Test mit zwei Typparametern definiert. Der zweite Typparameter hat eine Basisklasseneinschränkung und eine Verweistypeinschränkung. Beim Ausführen des Programms werden die Einschränkungen mit der Type.GenericParameterAttributes-Eigenschaft und der Type.GetGenericParameterConstraints-Methode untersucht.


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

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: 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 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft