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

  • リファレンス

定義

名前空間:
System
アセンブリ:
System.Runtime.dll
アセンブリ:
mscorlib.dll
アセンブリ:
netstandard.dll
ソース:
Type.cs
ソース:
Type.cs
ソース:
Type.cs

注意事項

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

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

public:
 static Type ^ ReflectionOnlyGetType(System::String ^ typeName, bool throwIfNotFound, bool ignoreCase);
public static Type? ReflectionOnlyGetType (string typeName, bool throwIfNotFound, bool ignoreCase);
[System.Obsolete("ReflectionOnly loading is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0018", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static Type? ReflectionOnlyGetType (string typeName, bool throwIfNotFound, bool ignoreCase);
public static Type ReflectionOnlyGetType (string typeName, bool throwIfNotFound, bool ignoreCase);
static member ReflectionOnlyGetType : string * bool * bool -> Type
[<System.Obsolete("ReflectionOnly loading is not supported and throws PlatformNotSupportedException.", DiagnosticId="SYSLIB0018", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member ReflectionOnlyGetType : string * bool * bool -> Type
Public Shared Function ReflectionOnlyGetType (typeName As String, throwIfNotFound As Boolean, ignoreCase As Boolean) As Type

パラメーター

typeName
String

取得する Type のアセンブリ修飾名。

throwIfNotFound
Boolean

型が見つからない場合にtrue をスローするには TypeLoadException 。型が見つからない場合に false を返すには null 。 また、 false を指定すると、一部の例外条件は抑制されますが、すべての例外が抑制されるわけではありません。 「例外」セクションを参照してください。

ignoreCase
Boolean

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

戻り値

Type

存在する場合は、指定した名前を持つ型。それ以外の場合は null。 型が見つからない場合、throwIfNotFound パラメーターで null を返すか例外をスローするかを指定します。 一部の場合は、throwIfNotFound の値に関係なく、例外がスローされます。 「例外」を参照してください。

属性
ObsoleteAttribute

例外

ArgumentNullException

typeName が nullです。

TargetInvocationException

クラス初期化子が呼び出され、例外をスローします。

TypeLoadException

throwIfNotFound が true です。型が見つかりません。

または

throwIfNotFound が true です。 typeName に埋め込まれたタブなどの正しくない文字が含まれています。

または

throwIfNotFound が true です。 typeName は空の文字列です。

または

throwIfNotFound が true です。 typeName は無効なサイズの配列型を表します。

または

typeName が TypedReference オブジェクトの配列を表しています。

ArgumentException

typeName にはアセンブリ名は含まれません。

または

throwIfNotFound が true です。 typeName に正しくない構文 ("MyType[,*,]" など) が含まれています。

または

typeName が、型引数の 1 つとしてポインター型、 ByRef 型、または Void を持つジェネリック型を表しています。

または

typeName は型引数の数が正しくないジェネリック型を表します。

または

typeName がジェネリック型を表し、型引数のいずれかが、対応する型パラメーターの制約を満たしていません。

FileNotFoundException

throwIfNotFound が true です。アセンブリ、またはその依存関係のうちの 1 つが見つかりませんでした。

FileLoadException

アセンブリまたはその依存関係のうちの 1 つが見つかりましたが、読み込むことができませんでした。

BadImageFormatException

アセンブリまたはその依存関係のいずれかが、現在読み込まれているランタイムの有効なアセンブリではありません。

PlatformNotSupportedException

.NET Core および .NET 5 以降のみ:すべての場合。

注釈

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

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

パラメーターは throwIfNotFound 、型が見つからない場合の動作を指定し、「例外」セクションで説明されているように、他の特定の例外条件も抑制します。 の値に関係なく、一部の throwIfNotFound例外がスローされます。 たとえば、アセンブリが無効な場合、 BadImageFormatException が の場合throwIfNotFoundfalseでも がスローされます。

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

適用対象

こちらもご覧ください