Export (0) Print
Expand All

RuntimeTypeHandle Structure

Represents a type using an internal metadata token.

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

[SerializableAttribute]
[ComVisibleAttribute(true)]
public struct RuntimeTypeHandle : ISerializable

The RuntimeTypeHandle type exposes the following members.

  NameDescription
Public propertyValueGets a handle to the type represented by this instance.
Top

  NameDescription
Public methodSupported by the XNA FrameworkEquals(Object)Indicates whether the specified object is equal to the current RuntimeTypeHandle structure. (Overrides ValueType.Equals(Object).)

In XNA Framework, this member is overridden by Equals(Object).
Public methodSupported by Portable Class LibraryEquals(RuntimeTypeHandle)Indicates whether the specified RuntimeTypeHandle structure is equal to the current RuntimeTypeHandle structure.
Public methodSupported by the XNA FrameworkGetHashCodeReturns the hash code for the current instance. (Overrides ValueType.GetHashCode().)

In XNA Framework, this member is overridden by GetHashCode().
Public methodGetModuleHandleGets a handle to the module that contains the type represented by the current instance.
Public methodGetObjectDataPopulates a SerializationInfo with the data necessary to deserialize the type represented by the current instance.
Public methodSupported by the XNA FrameworkSupported by Portable Class LibraryGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodSupported by the XNA FrameworkToStringReturns the fully qualified type name of this instance. (Inherited from ValueType.)

In XNA Framework 3.0, this member is inherited from Object.ToString().
Top

  NameDescription
Public operatorStatic memberSupported by Portable Class LibraryEquality(Object, RuntimeTypeHandle)Indicates whether an object and a RuntimeTypeHandle structure are equal.
Public operatorStatic memberSupported by Portable Class LibraryEquality(RuntimeTypeHandle, Object)Indicates whether a RuntimeTypeHandle structure is equal to an object.
Public operatorStatic memberSupported by Portable Class LibraryInequality(Object, RuntimeTypeHandle)Indicates whether an object and a RuntimeTypeHandle structure are not equal.
Public operatorStatic memberSupported by Portable Class LibraryInequality(RuntimeTypeHandle, Object)Indicates whether a RuntimeTypeHandle structure is not equal to an object.
Top

The following example demonstrates how to obtain a RuntimeTypeHandle from a type or from an object, and how to turn the handle back into a type.

using System;
using System.Reflection;

public class MyClass1
{
    private int x=0;
    public int MyMethod()
    {
        return x;
    }
}

public class MyClass2
{
    public static void Main()
    {
        MyClass1 myClass1 = new MyClass1();

        // Get the RuntimeTypeHandle from an object.
        RuntimeTypeHandle myRTHFromObject = Type.GetTypeHandle(myClass1);
        // Get the RuntimeTypeHandle from a type.
        RuntimeTypeHandle myRTHFromType = typeof(MyClass1).TypeHandle;

        Console.WriteLine("\nmyRTHFromObject.Value:  {0}", myRTHFromObject.Value);
        Console.WriteLine("myRTHFromObject.GetType():  {0}", myRTHFromObject.GetType());
        Console.WriteLine("Get the type back from the handle...");
        Console.WriteLine("Type.GetTypeFromHandle(myRTHFromObject):  {0}", 
            Type.GetTypeFromHandle(myRTHFromObject));

        Console.WriteLine("\nmyRTHFromObject.Equals(myRTHFromType):  {0}", 
            myRTHFromObject.Equals(myRTHFromType));

        Console.WriteLine("\nmyRTHFromType.Value:  {0}", myRTHFromType.Value);
        Console.WriteLine("myRTHFromType.GetType():  {0}", myRTHFromType.GetType());
        Console.WriteLine("Get the type back from the handle...");
        Console.WriteLine("Type.GetTypeFromHandle(myRTHFromType):  {0}", 
            Type.GetTypeFromHandle(myRTHFromType));
    }
}

/* This code example produces output similar to the following:

myRTHFromObject.Value:  799464
myRTHFromObject.GetType():  System.RuntimeTypeHandle
Get the type back from the handle...
Type.GetTypeFromHandle(myRTHFromObject):  MyClass1

myRTHFromObject.Equals(myRTHFromType):  True

myRTHFromType.Value:  799464
myRTHFromType.GetType():  System.RuntimeTypeHandle
Get the type back from the handle...
Type.GetTypeFromHandle(myRTHFromType):  MyClass1
 */

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2015 Microsoft