Type.ReflectionOnlyGetType メソッド

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

Type.ReflectionOnlyGetType メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

大文字と小文字を区別する検索を実行し、型が見つからない場合に例外をスローするかどうかを指定して、指定した名前の Type を取得します。型は実行ではなくリフレクションのためだけに読み込まれます。

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

Visual Basic (宣言)

Public Shared Function ReflectionOnlyGetType
 ( _
    typeName As String, _
    throwIfNotFound As Boolean, _
    ignoreCase As Boolean _
) As Type

Visual Basic (使用法)

Dim typeName As String
Dim throwIfNotFound As Boolean
Dim ignoreCase As Boolean
Dim returnValue As Type

returnValue = Type.ReflectionOnlyGetType(typeName, throwIfNotFound, ignoreCase)

C#

public static Type ReflectionOnlyGetType (
    string typeName,
    bool throwIfNotFound,
    bool ignoreCase
)

C++

public:
static Type^ ReflectionOnlyGetType (
    String^ typeName, 
    bool throwIfNotFound, 
    bool ignoreCase
)

J#

public static Type ReflectionOnlyGetType (
    String typeName, 
    boolean throwIfNotFound, 
    boolean ignoreCase
)

JScript

public static function ReflectionOnlyGetType
 (
    typeName : String, 
    throwIfNotFound : boolean, 
    ignoreCase : boolean
) : Type

パラメータ

typeName

取得する Type の名前。

throwIfNotFound

型が見つからない場合に TypeLoadException をスローするには true。型が見つからない場合に null 参照 (Visual Basic では Nothing) を返すには false。

ignoreCase

大文字と小文字を区別せずに typeName の検索を実行するには true。大文字と小文字を区別して typeName の検索を実行するには false。

戻り値
存在する場合は、指定した名前を持つ Type。それ以外の場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
ArgumentNullException	typeName が null 参照 (Visual Basic では Nothing) です。
TargetInvocationException	クラス初期化子が呼び出され、例外をスローしました。
TypeLoadException	throwIfNotFound が true であり、型は見つかりません。
ArgumentException	typeName が無効です。たとえば、無効な文字が含まれているか、長さが 0 の文字列です。

解説

型を含んでいるアセンブリがリフレクションのみのコンテキストにまだ読み込まれていない状態で、型がアセンブリ修飾されている場合、ReflectionOnlyGetType メソッドを使用することは、最初に ReflectionOnlyLoad メソッドでリフレクションのみのアセンブリを読み込み、続いてアセンブリの System.Reflection.Assembly.GetType メソッドを呼び出して型を読み込むことと同じです。型名の指定の詳細については、GetType(String,Boolean,Boolean) メソッド オーバーロードのトピックを参照してください。

アセンブリが実行のために既に読み込まれている場合は、別のコピーがリフレクションのみのコンテキストに読み込まれます。

throwIfNotFound パラメータは、型が見つからなかった場合の動作にのみ影響します。スローされる可能性のあるその他の例外には影響しません。特に、型が見つかっても読み込むことができない場合は、throwIfNotFound が false であっても TypeLoadException がスローされます。

リフレクションのみのコンテキストの使用方法の詳細については、「方法 : リフレクションのみのコンテキストにアセンブリを読み込む」を参照してください。

プラットフォーム

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 名前空間
String クラス
TypeLoadException
ReflectionPermission
AssemblyQualifiedName
GetAssembly
GetType
AssemblyName
その他の技術情報
完全修飾型名の指定
方法 : リフレクションのみのコンテキストにアセンブリを読み込む