Type.ReflectionOnlyGetType(String, Boolean, Boolean) Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

Type.cs

Perhatian

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Type Mendapatkan dengan nama yang ditentukan, menentukan apakah akan melakukan pencarian peka huruf besar/kecil dan apakah akan melemparkan pengecualian jika jenisnya tidak ditemukan. Jenis dimuat hanya untuk refleksi, bukan untuk eksekusi.

public:
 static Type ^ ReflectionOnlyGetType(System::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);

[<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

Parameter

typeName

String

Nama assembly-qualified untuk Type mendapatkan.

throwIfNotFound

Boolean

true untuk melemparkan TypeLoadException jika jenis tidak dapat ditemukan; false untuk mengembalikan null jika jenis tidak dapat ditemukan. Menentukan false juga menekan beberapa kondisi pengecualian lainnya, tetapi tidak semuanya. Lihat bagian Pengecualian.

ignoreCase

Boolean

true untuk melakukan pencarian yang tidak peka huruf besar/kecil untuk typeName; false untuk melakukan pencarian peka huruf besar/kecil untuk typeName.

Mengembalikan

Type

Jenis dengan nama yang ditentukan, jika ditemukan; jika tidak, null. Jika jenis tidak ditemukan, throwIfNotFound parameter menentukan apakah null dikembalikan atau pengecualian dilemparkan. Dalam beberapa kasus, pengecualian dilemparkan terlepas dari throwIfNotFoundnilai . Lihat bagian Pengecualian.

Atribut

ObsoleteAttribute

Pengecualian

ArgumentNullException

typeNameadalah null.

TargetInvocationException

Penginisialisasi kelas dipanggil dan melemparkan pengecualian.

TypeLoadException

throwIfNotFound adalah true dan jenisnya tidak ditemukan.

-atau-

throwIfNotFound adalah true dan typeName berisi karakter yang tidak valid, seperti tab yang disematkan.

-atau-

throwIfNotFound adalah true dan typeName adalah string kosong.

-atau-

throwIfNotFound adalah true dan typeName mewakili jenis array dengan ukuran yang tidak valid.

-atau-

typeName mewakili array TypedReference objek.

ArgumentException

typeName tidak menyertakan nama rakitan.

-atau-

throwIfNotFound adalah true dan typeName berisi sintaks yang tidak valid; misalnya, "MyType[,*,]".

-atau-

typeName mewakili jenis generik yang memiliki jenis penunjuk, ByRef jenis, atau Void sebagai salah satu argumen jenisnya.

-atau-

typeName mewakili jenis generik yang memiliki jumlah argumen jenis yang salah.

-atau-

typeName mewakili jenis generik, dan salah satu argumen jenisnya tidak memenuhi batasan untuk parameter jenis yang sesuai.

FileNotFoundException

throwIfNotFound adalah true dan perakitan atau salah satu dependensinya tidak ditemukan.

FileLoadException

Rakitan atau salah satu dependensinya ditemukan, tetapi tidak dapat dimuat.

BadImageFormatException

Rakitan atau salah satu dependensinya bukan rakitan yang valid untuk runtime yang saat ini dimuat.

PlatformNotSupportedException

Hanya .NET Core dan .NET 5+: Dalam semua kasus.

Keterangan

Jika rakitan yang berisi jenis belum dimuat ke dalam konteks khusus refleksi, menggunakan ReflectionOnlyGetType metode ini setara dengan terlebih dahulu memuat rakitan hanya untuk pantulan, menggunakan ReflectionOnlyLoad metode , lalu memuat jenis dengan memanggil metode assembly Assembly.GetType . Untuk informasi tentang nama yang memenuhi syarat rakitan, lihat Type.AssemblyQualifiedName properti . Untuk detail tambahan tentang menentukan nama jenis, lihat GetType(String, Boolean, Boolean) metode kelebihan beban.

Jika rakitan sudah dimuat untuk eksekusi, salinan lain dimuat ke dalam konteks khusus pantulan.

Parameter throwIfNotFound menentukan apa yang terjadi ketika jenis tidak ditemukan, dan juga menekan kondisi pengecualian tertentu lainnya, seperti yang dijelaskan di bagian Pengecualian. Beberapa pengecualian dilemparkan terlepas dari throwIfNotFoundnilai . Misalnya, jika assembly tidak valid, akan BadImageFormatException dilemparkan bahkan jika throwIfNotFound adalah false.

Untuk informasi selengkapnya tentang menggunakan konteks khusus refleksi, lihat Cara: Memuat Rakitan ke dalam Konteks Reflection-Only.

Lihat juga

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Menentukan Nama Jenis yang Sepenuhnya Memenuhi Syarat
• Petunjuk: Memuat Rakitan ke dalam Konteks Refleksi Saja