Assembly.GetType メソッド

リファレンス

定義

名前空間:: System.Reflection

アセンブリ:: System.Reflection.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定された型を表す Type オブジェクトを取得します。

オーバーロード

GetType(String, Boolean, Boolean)	指定した名前の Type オブジェクトをアセンブリインスタンスから取得します。オプションで、大文字と小文字の区別を無視したり、型が見つからない場合は例外をスローしたりできます。
GetType(String, Boolean)	指定した名前の Type オブジェクトをアセンブリインスタンスから取得し、型が見つからない場合は、オプションで例外をスローします。
GetType(String)	指定した名前の Type オブジェクトを、アセンブリインスタンスから取得します。
GetType()

GetType(String, Boolean, Boolean)

指定した名前の Type オブジェクトをアセンブリインスタンスから取得します。オプションで、大文字と小文字の区別を無視したり、型が見つからない場合は例外をスローしたりできます。

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError, bool ignoreCase);

public virtual Type GetType (string name, bool throwOnError, bool ignoreCase);

public virtual Type? GetType (string name, bool throwOnError, bool ignoreCase);

public Type GetType (string name, bool throwOnError, bool ignoreCase);

override this.GetType : string * bool * bool -> Type

Public Overridable Function GetType (name As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Public Function GetType (name As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

パラメーター

name: String

型の完全な名前。

throwOnError: Boolean

型が見つからなかったときに例外をスローする場合は true。null を返す場合は false。

ignoreCase: Boolean

型名の大文字と小文字の違いを無視する場合は true。それ以外の場合は false。

戻り値

Type

指定されているクラスを表すオブジェクト。

実装

GetType(String, Boolean, Boolean)

例外

ArgumentException

name が無効です。

または -

name の長さが 1024 文字を超えています。

ArgumentNullException

name が nullです。

TypeLoadException

throwOnError が trueであり、型が見つかりません。

FileNotFoundException

name には見つからなかった依存アセンブリが必要です。

FileLoadException

name には、見つかったものの読み込めなかった依存アセンブリが必要です。

または -

現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、name には事前に読み込まれていない依存アセンブリが必要です。

BadImageFormatException

name には依存アセンブリが必要ですが、ファイルは有効なアセンブリではありません。

または -

name には、現在読み込まれているバージョンより新しいバージョンのランタイム用にコンパイルされた依存アセンブリが必要です。

注釈

このメソッドは、現在のアセンブリインスタンスのみを検索します。パラメーターには name 名前空間が含まれますが、アセンブリは含まれません。他のアセンブリで型を検索するには、メソッドオーバーロードを Type.GetType(String) 使用します。このオーバーロードには、必要に応じて、型名の一部としてアセンブリ表示名を含めることができます。

注意

型が別のアセンブリに転送された場合でも、このメソッドによって返されます。型転送の詳細については、「共通言語ランタイムでの型転送」を参照してください。

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

適用対象

GetType(String, Boolean)

指定した名前の Type オブジェクトをアセンブリインスタンスから取得し、型が見つからない場合は、オプションで例外をスローします。

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError);

public virtual Type? GetType (string name, bool throwOnError);

public virtual Type GetType (string name, bool throwOnError);

override this.GetType : string * bool -> Type

Public Overridable Function GetType (name As String, throwOnError As Boolean) As Type

パラメーター

name: String

型の完全な名前。

throwOnError: Boolean

型が見つからなかったときに例外をスローする場合は true。null を返す場合は false。

戻り値

Type

指定されているクラスを表すオブジェクト。

実装

GetType(String, Boolean)

例外

ArgumentException

name が無効です。

または -

name の長さが 1024 文字を超えています。

ArgumentNullException

name が nullです。

TypeLoadException

throwOnError が trueであり、型が見つかりません。

FileNotFoundException

name には見つからなかった依存アセンブリが必要です。

FileLoadException

name には、見つかったものの読み込めなかった依存アセンブリが必要です。

または -

現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、name には事前に読み込まれていない依存アセンブリが必要です。

BadImageFormatException

name には依存アセンブリが必要ですが、ファイルは有効なアセンブリではありません。

または -

name には、現在読み込まれているバージョンより新しいバージョンのランタイム用にコンパイルされた依存アセンブリが必要です。

注釈

注意

適用対象

GetType(String)

指定した名前の Type オブジェクトを、アセンブリインスタンスから取得します。

public:
 virtual Type ^ GetType(System::String ^ name);

public virtual Type GetType (string name);

public virtual Type? GetType (string name);

override this.GetType : string -> Type

Public Overridable Function GetType (name As String) As Type

パラメーター

name: String

型の完全な名前。

戻り値

Type

指定したクラスを表すオブジェクト。クラスが見つからない場合は null。

実装

GetType(String)

例外

ArgumentException

name が無効です。

ArgumentNullException

name が nullです。

FileNotFoundException

name には見つからなかった依存アセンブリが必要です。

FileLoadException

name には、見つかったものの読み込めなかった依存アセンブリが必要です。

または -

現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、name には事前に読み込まれていない依存アセンブリが必要です。

注: Windows Microsoft Store アプリまたはポータブルクラスライブラリの .NET では、代わりに基底クラスの例外IOExceptionをキャッチします。

BadImageFormatException

name には依存アセンブリが必要ですが、ファイルは有効なアセンブリではありません。

または -

name には、現在読み込まれているバージョンより新しいバージョンのランタイム用にコンパイルされた依存アセンブリが必要です。

例

次の例では、名前空間に抽象 MeansOfTransportation クラスを Transportation 定義します。メソッドを GetType(String) 呼び出してオブジェクトを Type 取得し、メソッドを Type.GetProperties 呼び出して型のプロパティを表すオブジェクトの PropertyInfo 配列を取得し、型の抽象プロパティに関する情報を表示します。メソッドの GetType(String) 呼び出しでは、型の完全修飾名 (つまり、型名と共に名前空間) が使用されることに注意してください。

using System;
using System.Reflection;

public class Example
{
    public static void Main()
    {
        Assembly assem = typeof(Example).Assembly;
        Type t = assem.GetType("Transportation.MeansOfTransportation");
        if (t != null)
        {
            Console.WriteLine($"Virtual properties in type {t.FullName}:");
            PropertyInfo[] props = t.GetProperties();
            int nVirtual = 0;
            for (int ctr = 0; ctr < props.Length; ctr++)
            {
                if (props[ctr].GetMethod.IsVirtual)
                {
                    Console.WriteLine($"   {props[ctr].Name} (type {props[ctr].PropertyType.FullName})");
                    nVirtual++;
                }
            }

            if (nVirtual == 0)
                Console.WriteLine("   No virtual properties");
        }
    }
}

namespace Transportation
{
    public abstract class MeansOfTransportation
    {
        abstract public bool HasWheels { get; set; }
        abstract public int Wheels { get; set; }
        abstract public bool ConsumesFuel { get; set; }
        abstract public bool Living { get; set; }
    }
}
// The example displays the following output:
//    Virtual properties in type Transportation.MeansOfTransportation:
//       HasWheels (type System.Boolean)
//       Wheels (type System.Int32)
//       ConsumesFuel (type System.Boolean)
//       Living (type System.Boolean)

Imports System.Reflection

Module Example
   Public Sub Main()
      Dim assem As Assembly = GetType(Example).Assembly
      Dim t As Type = assem.GetType("Transportation.MeansOfTransportation")
      If Not t Is Nothing Then
         Console.WriteLine("Virtual properties in type {0}:", 
                           t.FullName)
         Dim props() As PropertyInfo = t.GetProperties()
         Dim nVirtual As Integer = 0
         For ctr As Integer = 0 To props.Length - 1
            If props(ctr).GetMethod.IsVirtual Then
               Console.WriteLine("   {0} (type {1})",
                                 props(ctr).Name, 
                                 props(ctr).PropertyType.FullName)
               nVirtual += 1
            End If
         Next
         If nVirtual = 0 Then 
            Console.WriteLine("   No virtual properties")
         End If   
      End If   
   End Sub
End Module

Namespace Transportation
   Public MustInherit Class MeansOfTransportation
      Public MustOverride Property HasWheels As Boolean
      Public MustOverride Property Wheels As Integer
      Public MustOverride Property ConsumesFuel As Boolean
      Public MustOverride Property Living As Boolean
   End Class
End Namespace
' The example displays the following output:
'    Virtual properties in type Transportation.MeansOfTransportation:
'       HasWheels (type System.Boolean)
'       Wheels (type System.Int32)
'       ConsumesFuel (type System.Boolean)
'       Living (type System.Boolean)

注釈

注意

適用対象

GetType()

public:
 virtual Type ^ GetType();

public Type GetType ();

override this.GetType : unit -> Type

Public Function GetType () As Type

戻り値

Type

実装

GetType()

適用対象

Assembly.GetType メソッド

定義

オーバーロード

GetType(String, Boolean, Boolean)

パラメーター

戻り値

実装

例外

注釈

適用対象

GetType(String, Boolean)

パラメーター

戻り値

実装

例外

注釈

適用対象

GetType(String)

パラメーター

戻り値

実装

例外

例

注釈

適用対象

GetType()

戻り値

実装

適用対象

その他のリソース