Type.GetType メソッド (String, Boolean, Boolean)

検索で大文字と小文字を区別するかどうか、および Type の読み込み中にエラーが発生した場合に例外をスローするかどうかを指定して、指定した名前の Type を取得します。

Overloads Public Shared Function GetType( _
   ByVal typeName As String, _   ByVal throwOnError As Boolean, _   ByVal ignoreCase As Boolean _) As Type
[C#]
public static Type GetType(stringtypeName,boolthrowOnError,boolignoreCase);
[C++]
public: static Type* GetType(String* typeName,boolthrowOnError,boolignoreCase);
[JScript]
public static function GetType(
   typeName : String,throwOnError : Boolean,ignoreCase : Boolean) : Type;

パラメータ

• typeName
  取得する Type の名前。

• throwOnError
  発生した例外をすべてスローする場合は true 。

  または

  発生した例外をすべて無視する場合は false 。

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

戻り値

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

例外

解説

GetType は、ディスクから読み込まれたアセンブリ上だけで動作します。 System.Reflection.Emit サービスを使用して定義した動的アセンブリ内で定義した型を検索するために GetType を呼び出すと、矛盾する動作が発生する可能性があります。その動作は、動的アセンブリが永続的かどうかによって異なります。つまり、その動的アセンブリが System.Reflection.Emit.AssemblyBuilderAccess 列挙体の RunAndSave アクセス モードまたは Save アクセス モードのどちらを使用して作成されたかによって異なります。動的アセンブリが永続的で、 GetType が呼び出される前にディスクに書き込まれている場合、ローダーはディスク上に保存されているアセンブリを見つけて読み込み、そのアセンブリから型を取得します。 GetType が呼び出された時点でアセンブリがディスク上に保存されていない場合、このメソッドは null 参照 (Visual Basic では Nothing) を返します。 GetType は一時動的アセンブリを認識しないため、一時動的アセンブリ内の型を取得するために GetType を呼び出すと、 null 参照 (Nothing) が返されます。

動的モジュールの GetType を使用するには、 AppDomain.AssemblyResolve イベントをサブスクライブし、保存する前に GetType を呼び出します。保存する前に呼び出さないと、メモリに 2 つのコピーが作成されることになります。

要求された型がパブリックではなく、呼び出し元に現在のアセンブリ外の非パブリック オブジェクトをリフレクションするための ReflectionPermission がない場合、このメソッドは null 参照 (Nothing) を返します。

型に対するリフレクション時に Get メソッドによって返される基本クラスのメンバを次の表に示します。

1. 名前と署名による隠ぺいでは、カスタム修飾子、戻り値の型、パラメータの型、sentinel、およびアンマネージ呼び出し規約を含めて、署名のすべての部分が判断の対象となります。これはバイナリ比較です。
2. リフレクションの場合、プロパティおよびイベントは名前と署名によって隠ぺいされています。基本クラスに get アクセサと set アクセサの両方を持つプロパティがあり、派生クラスには get アクセサしかない場合、派生クラスのプロパティにより基本クラスのプロパティが隠ぺいされ、基本クラスの set アクセサにはアクセスできません。
3. カスタム属性は、共通の型システムの一部ではありません。

使用できるクラスのテーブルに事前に読み込まれていない限り、配列や COM 型は検索対象になりません。

typeName には、単純型名、名前空間を含む型名、またはアセンブリ名の指定を含む複合名を指定できます。

typeName に Type の名前だけが含まれている場合、このメソッドは最初に呼び出し元のオブジェクトのアセンブリで検索を行い、次に mscorlib.dll アセンブリで検索を行います。typeName が部分アセンブリ名または完全アセンブリ名で完全限定されている場合、このメソッドは指定されたアセンブリで検索を行います。

AssemblyQualifiedName は、入れ子になった型とアセンブリ名を含む完全限定型名を返すことができます。入れ子になったクラスに対して、共通言語ランタイムをサポートするすべてのコンパイラは簡易名を生成し、リフレクションが、照会されたときに次の規則に従って完全限定名を生成します。

たとえば、クラスの完全限定名は次のようになります。

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

名前空間が TopNamespace.Sub+Namespace である場合、プラス記号 (+) が、入れ子になったクラスの区切り文字として解釈されないように、プラス記号 (+) の前にエスケープ文字 (\) を付ける必要があります。リフレクションは、この文字列を次のように生成します。

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass,MyAssembly

"++" は "\+\+"、"\" は "\\" となります。

この完全限定名は永続化でき、後で Type を読み込むために使用できます。 Type を検索して読み込むには、型名だけ、またはアセンブリ限定型名のいずれかを指定して GetType を使用します。型名だけを指定して GetType を使用した場合は、呼び出し元のアセンブリの Type だけが検索され、次に System アセンブリが検索されます。アセンブリ限定型名を指定して GetType を使用した場合は、任意のアセンブリ内の Type が検索されます。

型名の末尾には、その型に関する追加情報を示す文字を追加できます。たとえば、その型が参照型か、ポインタ型か、配列型かなどを表す文字を追加できます。このような末尾の文字を除いて型名だけを取得するには、 t.GetElementType().ToString() を使用します。 t が型を示します。

アセンブリ名を除くすべての型名コンポーネントで、スペースには意味があります。アセンブリ名では、区切り記号 ',' の前のスペースには意味がありますが、区切り記号 ',' の後のスペースは無視されます。

さまざまな種類の GetType で使用する構文を次の表に示します。

.NET Compact Framework - Windows CE .NET プラットフォームに関する注意点: ignoreCase パラメータはサポートされていないため、 false に設定する必要があります。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

.NET Framework セキュリティ:

• ReflectionPermission (非パブリック オブジェクトをリフレクション操作するために必要なアクセス許可) ReflectionPermissionFlag.TypeInformation (関連する列挙体)

参照

Type クラス | Type メンバ | System 名前空間 | Type.GetType オーバーロードの一覧 | String | TypeLoadException | ReflectionPermission | AssemblyQualifiedName | GetAssembly | GetType | AssemblyName | 完全限定型名の指定