Type.GenericParameterPosition Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Position des Typparameters in der Typparameterliste des generischen Typs oder der Methode ab, die den Parameter deklariert hat, wenn das Type Objekt einen Typparameter eines generischen Typs oder einer generischen Methode darstellt.
public:
abstract property int GenericParameterPosition { int get(); };
public:
virtual property int GenericParameterPosition { int get(); };
public abstract int GenericParameterPosition { get; }
public virtual int GenericParameterPosition { get; }
member this.GenericParameterPosition : int
Public MustOverride ReadOnly Property GenericParameterPosition As Integer
Public Overridable ReadOnly Property GenericParameterPosition As Integer
Eigenschaftswert
Die Position eines Typparameters in der Typparameterliste des generischen Typs oder der Generischen Methode, die den Parameter definiert. Positionsnummern beginnen bei 0.
Ausnahmen
Der aktuelle Typ stellt keinen Typparameter dar. Das heißt, IsGenericParameter gibt zurück false.
Beispiele
Im folgenden Beispiel wird eine generische Klasse mit zwei Typparametern definiert und eine zweite generische Klasse definiert, die von der ersten Klasse abgeleitet wird. Die Basisklasse der abgeleiteten Klasse weist zwei Typargumente auf: die erste ist Int32, und die zweite ist ein Typparameter des abgeleiteten Typs. Im Beispiel werden Informationen zu diesen generischen Klassen angezeigt, einschließlich der positionen, die von der GenericParameterPosition Eigenschaft gemeldet wurden.
using System;
using System.Reflection;
using System.Collections.Generic;
// Define a base class with two type parameters.
public class Base<T, U> { }
// Define a derived class. The derived class inherits from a constructed
// class that meets the following criteria:
// (1) Its generic type definition is Base<T, U>.
// (2) It specifies int for the first type parameter.
// (3) For the second type parameter, it uses the same type that is used
// for the type parameter of the derived class.
// Thus, the derived class is a generic type with one type parameter, but
// its base class is an open constructed type with one type argument and
// one type parameter.
public class Derived<V> : Base<int, V> { }
public class Test
{
public static void Main()
{
Console.WriteLine(
"\r\n--- Display a generic type and the open constructed");
Console.WriteLine(" type from which it is derived.");
// Create a Type object representing the generic type definition
// for the Derived type, by omitting the type argument. (For
// types with multiple type parameters, supply the commas but
// omit the type arguments.)
//
Type derivedType = typeof(Derived<>);
DisplayGenericTypeInfo(derivedType);
// Display its open constructed base type.
DisplayGenericTypeInfo(derivedType.BaseType);
}
private static void DisplayGenericTypeInfo(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);
Console.WriteLine("\tDoes it have unassigned generic parameters? {0}",
t.ContainsGenericParameters);
if (t.IsGenericType)
{
// If this is a generic type, display the type arguments.
//
Type[] typeArguments = t.GetGenericArguments();
Console.WriteLine("\tList type arguments ({0}):",
typeArguments.Length);
foreach (Type tParam in typeArguments)
{
// IsGenericParameter is true only for generic type
// parameters.
//
if (tParam.IsGenericParameter)
{
Console.WriteLine(
"\t\t{0} (unassigned - parameter position {1})",
tParam,
tParam.GenericParameterPosition);
}
else
{
Console.WriteLine("\t\t{0}", tParam);
}
}
}
}
}
/* This example produces the following output:
--- Display a generic type and the open constructed
type from which it is derived.
Derived`1[V]
Is this a generic type definition? True
Is it a generic type? True
Does it have unassigned generic parameters? True
List type arguments (1):
V (unassigned - parameter position 0)
Base`2[System.Int32,V]
Is this a generic type definition? False
Is it a generic type? True
Does it have unassigned generic parameters? True
List type arguments (2):
System.Int32
V (unassigned - parameter position 0)
*/
open System
open System.Reflection
open System.Collections.Generic
// Define a base class with two type parameters.
type Base<'T, 'U>() = class end
// Define a derived class. The derived class inherits from a constructed
// class that meets the following criteria:
// (1) Its generic type definition is Base<T, U>.
// (2) It specifies int for the first type parameter.
// (3) For the second type parameter, it uses the same type that is used
// for the type parameter of the derived class.
// Thus, the derived class is a generic type with one type parameter, but
// its base class is an open constructed type with one type argument and
// one type parameter.
type Derived<'V>() = inherit Base<int, 'V>()
let displayGenericTypeInfo (t: Type) =
printfn $"\n{t}"
printfn $"\tIs this a generic type definition? {t.IsGenericTypeDefinition}"
printfn $"\tIs it a generic type? {t.IsGenericType}"
printfn $"\tDoes it have unassigned generic parameters? {t.ContainsGenericParameters}"
if t.IsGenericType then
// If this is a generic type, display the type arguments.
let typeArguments = t.GetGenericArguments()
printfn $"\tList type arguments ({typeArguments.Length}):"
for tParam in typeArguments do
// IsGenericParameter is true only for generic type
// parameters.
if tParam.IsGenericParameter then
printfn $"\t\t{tParam} (unassigned - parameter position {tParam.GenericParameterPosition})"
else
printfn $"\t\t{tParam}"
printfn $"\r\n--- Display a generic type and the open constructed"
printfn $" type from which it is derived."
// Create a Type object representing the generic type definition
// for the Derived type, by omitting the type argument. (For
// types with multiple type parameters, supply the commas but
// omit the type arguments.)
//
let derivedType = (typeof<Derived<_>>).GetGenericTypeDefinition()
displayGenericTypeInfo derivedType
// Display its open constructed base type.
displayGenericTypeInfo derivedType.BaseType
(* This example produces the following output:
--- Display a generic type and the open constructed
type from which it is derived.
Derived`1[V]
Is this a generic type definition? True
Is it a generic type? True
Does it have unassigned generic parameters? True
List type arguments (1):
V (unassigned - parameter position 0)
Base`2[System.Int32,V]
Is this a generic type definition? False
Is it a generic type? True
Does it have unassigned generic parameters? True
List type arguments (2):
System.Int32
V (unassigned - parameter position 0)
*)
Imports System.Reflection
Imports System.Collections.Generic
' Define a base class with two type parameters.
Public Class Base(Of T, U)
End Class
' Define a derived class. The derived class inherits from a constructed
' class that meets the following criteria:
' (1) Its generic type definition is Base<T, U>.
' (2) It uses int for the first type parameter.
' (3) For the second type parameter, it uses the same type that is used
' for the type parameter of the derived class.
' Thus, the derived class is a generic type with one type parameter, but
' its base class is an open constructed type with one assigned type
' parameter and one unassigned type parameter.
Public Class Derived(Of V)
Inherits Base(Of Integer, V)
End Class
Public Class Test
Public Shared Sub Main()
Console.WriteLine(vbCrLf _
& "--- Display a generic type and the open constructed")
Console.WriteLine(" type from which it is derived.")
' Create a Type object representing the generic type definition
' for the Derived type, by omitting the type argument. (For
' types with multiple type parameters, supply the commas but
' omit the type arguments.)
'
Dim derivedType As Type = GetType(Derived(Of ))
DisplayGenericTypeInfo(derivedType)
' Display its open constructed base type.
DisplayGenericTypeInfo(derivedType.BaseType)
End Sub
Private Shared Sub DisplayGenericTypeInfo(ByVal t As Type)
Console.WriteLine(vbCrLf & "{0}", t)
Console.WriteLine(vbTab & "Is this a generic type definition? " _
& t.IsGenericTypeDefinition)
Console.WriteLine(vbTab & "Is it a generic type? " _
& t.IsGenericType)
Console.WriteLine(vbTab _
& "Does it have unassigned generic parameters? " _
& t.ContainsGenericParameters)
If t.IsGenericType Then
' If this is a generic type, display the type arguments.
'
Dim typeArguments As Type() = t.GetGenericArguments()
Console.WriteLine(vbTab & "List type arguments (" _
& typeArguments.Length & "):")
For Each tParam As Type In typeArguments
' IsGenericParameter is true only for generic type
' parameters.
'
If tParam.IsGenericParameter Then
Console.WriteLine(vbTab & vbTab & tParam.ToString() _
& " (unassigned - parameter position " _
& tParam.GenericParameterPosition & ")")
Else
Console.WriteLine(vbTab & vbTab & tParam.ToString())
End If
Next tParam
End If
End Sub
End Class
' This example produces the following output:
'
'--- Display a generic type and the open constructed
' type from which it is derived.
'
'Derived`1[V]
' Is this a generic type definition? True
' Is it a generic type? True
' Does it have unassigned generic parameters? True
' List type arguments (1):
' V (unassigned - parameter position 0)
'
'Base`2[System.Int32,V]
' Is this a generic type definition? False
' Is it a generic type? True
' Does it have unassigned generic parameters? True
' List type parameters (2):
' System.Int32
' V (unassigned - parameter position 0)
'
Hinweise
Die GenericParameterPosition Eigenschaft gibt die Position eines Typparameters in der Parameterliste der generischen Typdefinition oder generische Methodendefinition zurück, in der der Typparameter ursprünglich definiert wurde. Die DeclaringType Eigenschaften DeclaringMethod identifizieren den generischen Typ oder die Methodendefinition:
Wenn die DeclaringMethod Eigenschaft eine MethodInfo, die MethodInfo eine generische Methodendefinition darstellt, und das aktuelle Type Objekt einen Typparameter dieser generischen Methodendefinition darstellt.
Wenn die DeclaringMethod Eigenschaft zurückgegeben wird
null, gibt die DeclaringType Eigenschaft immer ein Type Objekt zurück, das eine generische Typdefinition darstellt, und das aktuelle Type Objekt stellt einen Typparameter dieser generischen Typdefinition dar.
Um den richtigen Kontext für den Wert der GenericParameterPosition Eigenschaft bereitzustellen, müssen Sie den generischen Typ oder die Methode identifizieren, zu dem ein Typparameter gehört. Betrachten Sie beispielsweise den Rückgabewert der generischen Methode GetSomething im folgenden Code:
public class B<T, U> { }
public class A<V>
{
public B<V, X> GetSomething<X>()
{
return new B<V, X>();
}
}
type B<'T, 'U>() = class end
type A<'V>() =
member _.GetSomething<'X>() =
B<'V, 'X>()
Public Class B(Of T, U)
End Class
Public Class A(Of V)
Public Function GetSomething(Of X)() As B(Of V, X)
Return New B(Of V, X)()
End Function
End Class
Der typ, von GetSomething dem zurückgegeben wird, hängt von den Typargumenten ab, die für die Klasse A und für GetSomething sich selbst bereitgestellt werden. Sie können ein MethodInfo For GetSomething- und von dem Sie den Rückgabetyp abrufen können. Wenn Sie die Typparameter des Rückgabetyps untersuchen, GenericParameterPosition wird 0 für beide zurückgegeben. Die Position von V 0, da V der erste Typparameter in der Typparameterliste für die Klasse Aist. Die Position von X 0, da X der erste Typparameter in der Typparameterliste für GetSomething.
Hinweis
Durch Aufrufen der GenericParameterPosition Eigenschaft wird eine Ausnahme ausgelöst, wenn der aktuelle Type Parameter keinen Typparameter darstellt. Wenn Sie die Typargumente eines geöffneten konstruierten Typs untersuchen, verwenden Sie die IsGenericParameter Eigenschaft, um zu ermitteln, welche Typparameter und welche Typen sind. Die IsGenericParameter Eigenschaft gibt für einen Typparameter zurück true . Anschließend können Sie die GenericParameterPosition Methode verwenden, um die Position abzurufen und die DeclaringMethod eigenschaften DeclaringType zu verwenden, um die generische Methode oder Typdefinition zu bestimmen, die sie definiert.