Binder.ChangeType メソッド

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

Binder.ChangeType メソッド

指定されているオブジェクトの型を特定の型に変更します。

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

Visual Basic (宣言)

Public MustOverride Function
 ChangeType ( _
    value As Object, _
    type As Type, _
    culture As CultureInfo _
) As Object

Visual Basic (使用法)

Dim instance As Binder
Dim value As Object
Dim type As Type
Dim culture As CultureInfo
Dim returnValue As Object

returnValue = instance.ChangeType(value, type, culture)

C#

public abstract Object ChangeType (
    Object value,
    Type type,
    CultureInfo culture
)

C++

public:
virtual Object^ ChangeType (
    Object^ value, 
    Type^ type, 
    CultureInfo^ culture
) abstract

J#

public abstract Object ChangeType (
    Object value, 
    Type type, 
    CultureInfo culture
)

JScript

public abstract function ChangeType (
    value : Object, 
    type : Type, 
    culture : CultureInfo
) : Object

パラメータ

value

新しい型に変更する値。

type

value の変換後の新しい型。

culture

データ型の強制変換を制御するために使用する CultureInfo のインスタンス。culture が null 参照 (Visual Basic では Nothing) の場合、現在のスレッドの CultureInfo が使用されます。

メモ
たとえば、このパラメータでは、1000 を表す String を Double 値に変換して指定する必要があります。これは、カルチャによって 1000 の表記が異なるためです。

戻り値

指定されている値を新しい型で保持しているオブジェクト。

解説

リフレクションは、共通の型システムにおけるアクセスに関する規則をモデル化します。たとえば、呼び出し元が同一アセンブリ内にある場合、呼び出し元に内部メンバに対する特別なアクセス許可は必要ありません。それ以外の場合は、呼び出し元に ReflectionPermission が必要です。このことは、プロテクト メンバ、プライベート メンバなどを検索する場合も同様です。

一般原則として、データを失わないように、ChangeType は型の強制拡大変換だけを実行します。型の強制拡大変換の例としては、32 ビット符号付き整数値から 64 ビット符号付き整数値への強制変換があります。この変換は、データが失われる可能性がある、型の強制縮小変換とは区別されます。型の強制縮小変換の例としては、64 ビット符号付き整数から 32 ビット符号付き整数への強制変換があります。

既定の ChangeType で実行される型の強制変換の一覧を次の表に示します。

変換元の型	変換後の型
任意の型	基本型
任意の型	実装するインターフェイス
Char	UInt16、UInt32、Int32、UInt64、Int64、Single、Double
Byte	Char、UInt16、Int16、UInt32、Int32、UInt64、Int64、Single、Double
SByte	Int16、Int32、Int64、Single、Double
UInt16	UInt32、Int32、UInt64、Int64、Single、Double
Int16	Int32、Int64、Single、Double
UInt32	UInt64、Int64、Single、Double
Int32	Int64、Single、Double
UInt64	Single、Double
Int64	Single、Double
Single	Double
非参照渡し	参照渡し

プラットフォーム

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

参照

関連項目
Binder クラス
Binder メンバ
System.Reflection 名前空間