Assembly.GetType メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された型を表す Type オブジェクトを取得します。
オーバーロード
GetType(String, Boolean, Boolean) |
指定した名前の Type オブジェクトをアセンブリ インスタンスから取得します。オプションで、大文字と小文字の区別を無視したり、型が見つからない場合は例外をスローしたりできます。 |
GetType(String, Boolean) |
指定した名前の Type オブジェクトをアセンブリ インスタンスから取得し、型が見つからない場合は、オプションで例外をスローします。 |
GetType(String) |
指定した名前の Type オブジェクトを、アセンブリ インスタンスから取得します。 |
GetType() |
GetType(String, Boolean, Boolean)
- ソース:
- Assembly.cs
- ソース:
- Assembly.cs
- ソース:
- Assembly.cs
指定した名前の 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
。
戻り値
指定されているクラスを表すオブジェクト。
実装
例外
name
が null
です。
throwOnError
が true
であり、型が見つかりません。
name
には見つからなかった依存アセンブリが必要です。
name
には、見つかったものの読み込めなかった依存アセンブリが必要です。
- または -
現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、name
には事前に読み込まれていない依存アセンブリが必要です。
typeName
には依存アセンブリが必要ですが、ファイルは現在読み込まれているランタイムの有効なアセンブリではありません。
注釈
このメソッドは、現在のアセンブリ インスタンスのみを検索します。 パラメーターには name
名前空間が含まれますが、アセンブリは含まれません。 他のアセンブリで型を検索するには、 メソッド オーバーロードを Type.GetType(String) 使用します。このオーバーロードには、必要に応じて、型名の一部としてアセンブリ表示名を含めることができます。
注意
型が別のアセンブリに転送された場合でも、このメソッドによって返されます。 型転送の詳細については、「 共通言語ランタイムでの型の転送」を参照してください。
パラメーターは throwOnError
、型が見つからない場合の動作にのみ影響します。 スローされる可能性のある他の例外には影響しません。 特に、型が見つかったが読み込めない場合は、 TypeLoadException が false
であってもスローthrowOnError
できます。
適用対象
GetType(String, Boolean)
- ソース:
- Assembly.cs
- ソース:
- Assembly.cs
- ソース:
- Assembly.cs
指定した名前の 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
。
戻り値
指定されているクラスを表すオブジェクト。
実装
例外
name
が null
です。
throwOnError
が true
であり、型が見つかりません。
name
には見つからなかった依存アセンブリが必要です。
name
には、見つかったものの読み込めなかった依存アセンブリが必要です。
- または -
現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、name
には事前に読み込まれていない依存アセンブリが必要です。
typeName
には依存アセンブリが必要ですが、ファイルは現在読み込まれているランタイムの有効なアセンブリではありません。
注釈
このメソッドは、現在のアセンブリ インスタンスのみを検索します。 パラメーターには name
名前空間が含まれますが、アセンブリは含まれません。 他のアセンブリで型を検索するには、 メソッド オーバーロードを Type.GetType(String) 使用します。このオーバーロードには、必要に応じて、型名の一部としてアセンブリ表示名を含めることができます。
注意
型が別のアセンブリに転送された場合でも、このメソッドによって返されます。 型転送の詳細については、「 共通言語ランタイムでの型の転送」を参照してください。
パラメーターは throwOnError
、型が見つからない場合の動作にのみ影響します。 スローされる可能性のある他の例外には影響しません。 特に、型が見つかったが読み込めない場合は、 TypeLoadException が false
であってもスローthrowOnError
できます。
適用対象
GetType(String)
- ソース:
- Assembly.cs
- ソース:
- Assembly.cs
- ソース:
- Assembly.cs
指定した名前の 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
型の完全な名前。
戻り値
指定したクラスを表すオブジェクト。クラスが見つからない場合は null
。
実装
例外
name
が無効です。
name
が null
です。
name
には見つからなかった依存アセンブリが必要です。
name
には、見つかったものの読み込めなかった依存アセンブリが必要です。
- または -
現在のアセンブリはリフレクションのみのコンテキストに読み込まれましたが、name
には事前に読み込まれていない依存アセンブリが必要です。
注: .NET for Windows ストア アプリ または ポータブル クラス ライブラリでは、代わりに基底クラスの例外 IOExceptionをキャッチします。
typeName
には依存アセンブリが必要ですが、ファイルは現在読み込まれているランタイムの有効なアセンブリではありません。
例
次の例では、 名前空間に抽象 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)
注釈
このメソッドは、現在のアセンブリ インスタンスのみを検索します。 パラメーターには name
名前空間が含まれますが、アセンブリは含まれません。 他のアセンブリで型を検索するには、 メソッド オーバーロードを Type.GetType(String) 使用します。このオーバーロードには、必要に応じて、型名の一部としてアセンブリ表示名を含めることができます。
注意
型が別のアセンブリに転送された場合でも、このメソッドによって返されます。 型転送の詳細については、「 共通言語ランタイムでの型の転送」を参照してください。
適用対象
.NET