_Type.TypeHandle プロパティ

.NET Framework クラス ライブラリ リファレンス

_Type.TypeHandle プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

COM オブジェクトに、Type.TypeHandle プロパティへのバージョンに依存しないアクセスが用意されています。

このプロパティは、CLS に準拠していません。  

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

ReadOnly Property TypeHandle As
 RuntimeTypeHandle

Visual Basic (使用法)

Dim instance As _Type
Dim value As RuntimeTypeHandle

value = instance.TypeHandle

C#

RuntimeTypeHandle TypeHandle { get; }

C++

property RuntimeTypeHandle TypeHandle {
    RuntimeTypeHandle get ();
}

J#

/** @property */
RuntimeTypeHandle get_TypeHandle ()

JScript

function get TypeHandle () : RuntimeTypeHandle

プロパティ値
現在の Type のハンドル。

解説

このプロパティは、アンマネージ コードからマネージ クラスにアクセスするためのプロパティであるため、マネージ コードからは呼び出さないでください。

Type.TypeHandle プロパティは、現在の Type のハンドルを取得します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
_Type インターフェイス
_Type メンバ
System.Runtime.InteropServices 名前空間

Type.TypeHandle プロパティ

現在の Type のハンドルを取得します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overridable ReadOnly
 Property TypeHandle As RuntimeTypeHandle

Visual Basic (使用法)

Dim instance As Type
Dim value As RuntimeTypeHandle

value = instance.TypeHandle

C#

public virtual RuntimeTypeHandle TypeHandle { get;
 }

C++

public:
virtual property RuntimeTypeHandle TypeHandle {
    RuntimeTypeHandle get ();
}

J#

/** @property */
public RuntimeTypeHandle get_TypeHandle ()

JScript

public function get TypeHandle
 () : RuntimeTypeHandle

プロパティ値
現在の Type のハンドル。

例外

例外の種類	条件
NotSupportedException	.NET Compact Framework は、現在このプロパティをサポートしていません。

解説

TypeHandle は、型を表す内部データ構造へのポインタをカプセル化します。このハンドルは、プロセスの有効期間中は一意です。ハンドルは取得されたアプリケーション ドメインでだけ有効です。

使用例

対応する型のハンドルを取得し、そのハンドルをハンドルから型を取得して表示を行うメソッドに渡す例を次に示します。

Visual Basic

Imports System
Imports System.Reflection
Imports Microsoft.VisualBasic
Class [MyClass]
    Public myField As Integer
 = 10
End Class '[MyClass]
Class Type_TypeHandle
    Public Shared Sub Main()
        Try
            Dim [myClass] As New
 [MyClass]()

            ' Get the type of MyClass.
            Dim myClassType As Type = [myClass].GetType()

            ' Get the runtime handle of MyClass.
            Dim myClassHandle As RuntimeTypeHandle
 = myClassType.TypeHandle

            DisplayTypeHandle(myClassHandle)
        Catch e As Exception
            Console.WriteLine("Exception: {0}", e.Message.ToString())
        End Try
    End Sub 'Main

    Public Shared Sub DisplayTypeHandle(ByVal
 myTypeHandle As RuntimeTypeHandle)
        ' Get the type from the handle.
        Dim myType As Type = Type.GetTypeFromHandle(myTypeHandle)
        ' Display the type.
        Console.WriteLine(ControlChars.NewLine + "Displaying the
 type from the handle:" + ControlChars.NewLine)
        Console.WriteLine("The type is {0}.", myType.ToString())
    End Sub 'DisplayTypeHandle
End Class 'Type_TypeHandle

C#

using System;
using System.Reflection;
class MyClass
{
    public int myField = 10;
}

class Type_TypeHandle
{
    public static void Main()
    {
        try
        {
            MyClass myClass = new MyClass();

            // Get the type of MyClass.
            Type myClassType = myClass.GetType();

            // Get the runtime handle of MyClass.
            RuntimeTypeHandle myClassHandle = myClassType.TypeHandle;
         
            DisplayTypeHandle(myClassHandle);
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception: {0}", e.Message );
        }
    }

    public static void DisplayTypeHandle(RuntimeTypeHandle
 myTypeHandle)
    {
        // Get the type from the handle.
        Type myType = Type.GetTypeFromHandle(myTypeHandle);      
        // Display the type.
        Console.WriteLine("\nDisplaying the type from the handle:\n");
        Console.WriteLine("The type is {0}.", myType.ToString());
    }
}

C++

using namespace System;
using namespace System::Reflection;
ref class MyClass
{
public:
   int myField;
};

void DisplayTypeHandle( RuntimeTypeHandle myTypeHandle )
{
   
   // Get the type from the handle.
   Type^ myType = Type::GetTypeFromHandle( myTypeHandle );
   
   // Display the type.
   Console::WriteLine( "\nDisplaying the type from the handle:\n" );
   Console::WriteLine( "The type is {0}.", myType );
}

int main()
{
   try
   {
      MyClass^ myClass = gcnew MyClass;
      
      // Get the type of MyClass.
      Type^ myClassType = myClass->GetType();
      
      // Get the runtime handle of MyClass.
      RuntimeTypeHandle myClassHandle = myClassType->TypeHandle;
      DisplayTypeHandle( myClassHandle );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e->Message );
   }

}

J#

import System.*;
import System.Reflection.*;
class MyClass
{
    public int myField = 10;
} //MyClass

class Type_TypeHandle
{
    public static void main(String[]
 args)
    {
        try {
            MyClass myClass = new MyClass();
            // Get the type of MyClass.
            Type myClassType = myClass.GetType();
            // Get the runtime handle of MyClass.
            RuntimeTypeHandle myClassHandle = myClassType.get_TypeHandle();
            DisplayTypeHandle(myClassHandle);
        }
        catch (System.Exception e) {
            Console.WriteLine("Exception: {0}", e.get_Message());
        }
    } //main

    public static void DisplayTypeHandle(RuntimeTypeHandle
 myTypeHandle)
    {
        // Get the type from the handle.
        Type myType = Type.GetTypeFromHandle(myTypeHandle);
        // Display the type.
        Console.WriteLine("\nDisplaying the type from the handle:\n");
        Console.WriteLine("The type is {0}.", myType.ToString());
    } //DisplayTypeHandle
} //Type_TypeHandle

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Type クラス
Type メンバ
System 名前空間
RuntimeTypeHandle 構造体
GetTypeHandle
GetTypeFromHandle