Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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 LibrarySupported in .NET for Windows Store appsEquals(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 LibrarySupported in .NET for Windows Store appsGetTypeGets 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 LibrarySupported in .NET for Windows Store appsEquality(Object, RuntimeTypeHandle)Indicates whether an object and a RuntimeTypeHandle structure are equal.
Public operatorStatic memberSupported by Portable Class LibrarySupported in .NET for Windows Store appsEquality(RuntimeTypeHandle, Object)Indicates whether a RuntimeTypeHandle structure is equal to an object.
Public operatorStatic memberSupported by Portable Class LibrarySupported in .NET for Windows Store appsInequality(Object, RuntimeTypeHandle)Indicates whether an object and a RuntimeTypeHandle structure are not equal.
Public operatorStatic memberSupported by Portable Class LibrarySupported in .NET for Windows Store appsInequality(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.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, 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 Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.