Edit

Share via

Module.ResolveType Method

Definition

Namespace:
System.Reflection
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Returns the type identified by a metadata token.

Overloads

ResolveType(Int32)

Returns the type identified by the specified metadata token.
ResolveType(Int32, Type[], Type[])

Returns the type identified by the specified metadata token, in the context defined by the specified generic type parameters.

ResolveType(Int32)

Source:
Module.cs
Source:
Module.cs
Source:
Module.cs
Source:
Module.cs

Returns the type identified by the specified metadata token.

public:
 Type ^ ResolveType(int metadataToken);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Trimming changes metadata tokens")]
public Type ResolveType(int metadataToken);
public Type ResolveType(int metadataToken);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Trimming changes metadata tokens")>]
member this.ResolveType : int -> Type
member this.ResolveType : int -> Type
Public Function ResolveType (metadataToken As Integer) As Type

Parameters

metadataToken
Int32

A metadata token that identifies a type in the module.

Returns

Type

A Type object representing the type that is identified by the specified metadata token.

Attributes
RequiresUnreferencedCodeAttribute

Exceptions

ArgumentException

metadataToken is not a token for a type in the scope of the current module.

-or-

metadataToken is a TypeSpec whose signature contains element type var (a type parameter of a generic type) or mvar (a type parameter of a generic method).

ArgumentOutOfRangeException

metadataToken is not a valid token in the scope of the current module.

Remarks

To resolve a metadata token for a TypeSpec whose signature contains ELEMENT_TYPE_VAR or ELEMENT_TYPE_MVAR, use the ResolveType(Int32, Type[], Type[]) method overload, which allows you to supply the necessary context. That is, when you are resolving a metadata token for a type that depends on the generic type parameters of the generic type and/or the generic method in which the token is embedded, you must use the overload that allows you to supply those type parameters.

Note

Information about metadata tokens can be found in the Common Language Infrastructure (CLI) documentation, especially "Partition II: Metadata Definition and Semantics". For more information, see ECMA 335 Common Language Infrastructure (CLI).

Applies to

ResolveType(Int32, Type[], Type[])

Source:
Module.cs
Source:
Module.cs
Source:
Module.cs
Source:
Module.cs

Returns the type identified by the specified metadata token, in the context defined by the specified generic type parameters.

public:
 virtual Type ^ ResolveType(int metadataToken, cli::array <Type ^> ^ genericTypeArguments, cli::array <Type ^> ^ genericMethodArguments);
public:
 Type ^ ResolveType(int metadataToken, cli::array <Type ^> ^ genericTypeArguments, cli::array <Type ^> ^ genericMethodArguments);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Trimming changes metadata tokens")]
public virtual Type ResolveType(int metadataToken, Type[]? genericTypeArguments, Type[]? genericMethodArguments);
public virtual Type ResolveType(int metadataToken, Type[] genericTypeArguments, Type[] genericMethodArguments);
public virtual Type ResolveType(int metadataToken, Type[]? genericTypeArguments, Type[]? genericMethodArguments);
public Type ResolveType(int metadataToken, Type[] genericTypeArguments, Type[] genericMethodArguments);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Trimming changes metadata tokens")>]
abstract member ResolveType : int * Type[] * Type[] -> Type
override this.ResolveType : int * Type[] * Type[] -> Type
abstract member ResolveType : int * Type[] * Type[] -> Type
override this.ResolveType : int * Type[] * Type[] -> Type
member this.ResolveType : int * Type[] * Type[] -> Type
Public Overridable Function ResolveType (metadataToken As Integer, genericTypeArguments As Type(), genericMethodArguments As Type()) As Type
Public Function ResolveType (metadataToken As Integer, genericTypeArguments As Type(), genericMethodArguments As Type()) As Type

Parameters

metadataToken
Int32

A metadata token that identifies a type in the module.

genericTypeArguments
Type[]

An array of Type objects representing the generic type arguments of the type where the token is in scope, or null if that type is not generic.

genericMethodArguments
Type[]

An array of Type objects representing the generic type arguments of the method where the token is in scope, or null if that method is not generic.

Returns

Type

A Type object representing the type that is identified by the specified metadata token.

Attributes
RequiresUnreferencedCodeAttribute

Exceptions

ArgumentException

metadataToken is not a token for a type in the scope of the current module.

-or-

metadataToken is a TypeSpec whose signature contains element type var (a type parameter of a generic type) or mvar (a type parameter of a generic method), and the necessary generic type arguments were not supplied for either or both of genericTypeArguments and genericMethodArguments.

ArgumentOutOfRangeException

metadataToken is not a valid token in the scope of the current module.

Remarks

Use the Type.GetGenericArguments method on the type where metadataToken is in scope to obtain an array of generic type arguments for genericTypeArguments. Use the MethodInfo.GetGenericArguments method on the method where metadataToken is in scope to obtain an array of generic type arguments for genericTypeArguments. It is always safe to provide these arguments, even when they are not needed.

Note

Information about metadata tokens can be found in the Common Language Infrastructure (CLI) documentation, especially "Partition II: Metadata Definition and Semantics". For more information, see ECMA 335 Common Language Infrastructure (CLI).

For code that demonstrates token resolution using the generic context (that is, the generic type parameters of the generic type and/or the generic method in which the token is embedded) see the ResolveMethod(Int32, Type[], Type[]) method.

Applies to