Export (0) Print
Expand All

RuntimeTypeHandle Class

Represents a type using an internal metadata token.

System.Object
  System.ValueType
    System.RuntimeTypeHandle

Namespace:  System
Assemblies:   System.Runtime (in System.Runtime.dll)
  mscorlib (in mscorlib.dll)

'Declaration
Public NotInheritable Class RuntimeTypeHandle _
	Inherits ValueType

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.

Imports System
Imports System.Reflection

Public Class MyClass1
    Private x As Integer = 0

    Public Function MyMethod() As Integer 
        Return x
    End Function 'MyMethod
End Class  

Public Class MyClass2

    Public Shared Sub Main()
        Dim myClass1 As New MyClass1()

        ' Get the RuntimeTypeHandle from an object. 
        Dim myRTHFromObject As RuntimeTypeHandle = Type.GetTypeHandle(myClass1)
        ' Get the RuntimeTypeHandle from a type. 
        Dim myRTHFromType As RuntimeTypeHandle = GetType(MyClass1).TypeHandle

        Console.WriteLine(vbLf & "myRTHFromObject.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(vbLf & "myRTHFromObject.Equals(myRTHFromType):  {0}", _
            myRTHFromObject.Equals(myRTHFromType))

        Console.WriteLine(vbLf & "myRTHFromType.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))
    End Sub  
End Class  

' This code example produces output similar to the following: 

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

'myRTHFromObject.Equals(myRTHFromType):  True 

'myRTHFromType.Value:  7549720 
'myRTHFromType.GetType():  System.RuntimeTypeHandle 
'Get the type back from the handle... 
'Type.GetTypeFromHandle(myRTHFromType):  MyClass1

.NET Framework

Supported in: 4.6, 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

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

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.
Show:
© 2014 Microsoft