Type.GetGenericTypeDefinition Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

Type.cs

Type Vrátí objekt, který představuje definici obecného typu, ze které lze vytvořit aktuální obecný typ.

public:
 virtual Type ^ GetGenericTypeDefinition();

public virtual Type GetGenericTypeDefinition();

abstract member GetGenericTypeDefinition : unit -> Type
override this.GetGenericTypeDefinition : unit -> Type

Public Overridable Function GetGenericTypeDefinition () As Type

Návraty

Type

Objekt Type představující obecný typ, ze kterého lze aktuální typ vytvořit.

Výjimky

InvalidOperationException

Aktuální typ není obecný typ. To znamená, IsGenericType že vrátí false.

NotSupportedException

Vyvolaná metoda není podporována v základní třídě. Odvozené třídy musí poskytovat implementaci.

Příklady

Následující příklad kódu vytvoří instanci vytvořeného typu pomocí běžného vytvoření instance a pak použije GetType a GetGenericTypeDefinition metody k načtení vytvořeného typu a definice obecného typu. Tento příklad používá obecný Dictionary<TKey,TValue> typ; vytvořený typ představuje Dictionary<TKey,TValue>Test objekty s řetězcovými klíči.

using System;
using System.Reflection;
using System.Collections.Generic;

public class Test
{
    public static void Main()
    {
        Console.WriteLine("\r\n--- Get the generic type that defines a constructed type.");

        // Create a Dictionary of Test objects, using strings for the
        // keys.       
        Dictionary<string, Test> d = new Dictionary<string, Test>();

        // Get a Type object representing the constructed type.
        //
        Type constructed = d.GetType();
        DisplayTypeInfo(constructed);

        Type generic = constructed.GetGenericTypeDefinition();
        DisplayTypeInfo(generic);
    }

    private static void DisplayTypeInfo(Type t)
    {
        Console.WriteLine("\r\n{0}", t);
        Console.WriteLine("\tIs this a generic type definition? {0}", 
            t.IsGenericTypeDefinition);
        Console.WriteLine("\tIs it a generic type? {0}", 
            t.IsGenericType);
        Type[] typeArguments = t.GetGenericArguments();
        Console.WriteLine("\tList type arguments ({0}):", typeArguments.Length);
        foreach (Type tParam in typeArguments)
        {
            Console.WriteLine("\t\t{0}", tParam);
        }
    }
}

/* This example produces the following output:

--- Get the generic type that defines a constructed type.

System.Collections.Generic.Dictionary`2[System.String,Test]
        Is this a generic type definition? False
        Is it a generic type? True
        List type arguments (2):
                System.String
                Test

System.Collections.Generic.Dictionary`2[TKey,TValue]
        Is this a generic type definition? True
        Is it a generic type? True
        List type arguments (2):
                TKey
                TValue
 */

open System
open System.Collections.Generic

type Test() = class end

let displayTypeInfo (t: Type) =
    printfn $"\n{t}"
    printfn $"\tIs this a generic type definition? {t.IsGenericTypeDefinition}"
    printfn $"\tIs it a generic type? {t.IsGenericType}"
    let typeArguments = t.GetGenericArguments()
    printfn $"\tList type arguments ({typeArguments.Length}):"
    for tParam in typeArguments do
        printfn $"\t\t{tParam}"

printfn "\n--- Get the generic type that defines a constructed type."

// Create a Dictionary of Test objects, using strings for the keys.
let d = Dictionary<string, Test>()

// Get a Type object representing the constructed type.
let constructed = d.GetType()
displayTypeInfo constructed

let generic = constructed.GetGenericTypeDefinition()
displayTypeInfo generic


(* This example produces the following output:

--- Get the generic type that defines a constructed type.

System.Collections.Generic.Dictionary`2[System.String,Test]
        Is this a generic type definition? False
        Is it a generic type? True
        List type arguments (2):
                System.String
                Test

System.Collections.Generic.Dictionary`2[TKey,TValue]
        Is this a generic type definition? True
        Is it a generic type? True
        List type arguments (2):
                TKey
                TValue
 *)

Imports System.Reflection
Imports System.Collections.Generic

Public Class Test
    Public Shared Sub Main() 
        Console.WriteLine(vbCrLf & "--- Get the generic type that defines a constructed type.")
        
        ' Create a Dictionary of Test objects, using strings for the
        ' keys.
        Dim d As New Dictionary(Of String, Test)
        
        ' Get a Type object representing the constructed type.
        '
        Dim constructed As Type = d.GetType()
        DisplayTypeInfo(constructed)
        
        Dim generic As Type = constructed.GetGenericTypeDefinition()
        DisplayTypeInfo(generic)
    End Sub
    
    Private Shared Sub DisplayTypeInfo(ByVal t As Type) 
        Console.WriteLine(vbCrLf & t.ToString())
        Console.WriteLine(vbTab & "Is this a generic type definition? " _
            & t.IsGenericTypeDefinition)
        Console.WriteLine(vbTab & "Is it a generic type? " _
            & t.IsGenericType)
        Dim typeArguments As Type() = t.GetGenericArguments()
        Console.WriteLine(vbTab & "List type arguments (" _
            & typeArguments.Length & "):")
        For Each tParam As Type In typeArguments
            Console.WriteLine(vbTab & vbTab & tParam.ToString())
        Next tParam
    End Sub
End Class

' This example produces the following output:
'
'--- Get the generic type that defines a constructed type.
'
'System.Collections.Generic.Dictionary`2[System.String,Test]
'        Is this a generic type definition? False
'        Is it a generic type? True
'        List type arguments (2):
'                System.String
'                Test
'
'System.Collections.Generic.Dictionary`2[TKey,TValue]
'        Is this a generic type definition? True
'        Is it a generic type? True
'        List type arguments (2):
'                TKey
'                TValue
'

Poznámky

Definice obecného typu je šablona, ze které lze vytvořit jiné typy. Například z definice G<T>obecného typu jazyka C# můžete vytvořit a vytvořit instanci typu G<int>. Vzhledem k objektu Type představujícímu tento vytvořený typ GetGenericTypeDefinition vrátí metoda definici obecného typu.

Pokud jsou vytvořeny dva vytvořené typy ze stejné definice obecného typu pomocí stejných argumentů typu, GetGenericTypeDefinition metoda vrátí stejný Type objekt pro oba typy.

Pokud voláte metodu GetGenericTypeDefinition u objektu Type , který již představuje definici obecného typu, vrátí aktuální Type.

Důležité

Pole obecných typů není samotné obecné. V kódu jazyka C# nebo v kódu A<int>[] v;Dim v() As A(Of Integer)jazyka Visual Basic není typ proměnné v obecný. Slouží IsGenericType k určení, zda typ je obecný před voláním GetGenericTypeDefinition.

Seznam invariantních podmínek pro termíny použité v obecné reflexi najdete v IsGenericType poznámkách k vlastnostem.

Viz také

• MakeGenericType(Type[])
• ContainsGenericParameters
• IsGenericTypeDefinition
• Reflexe a generické typy
• Postupy: Zkoumání a vytváření instancí obecných typů pomocí reflexe