Type.ReflectionOnlyGetType(String, Boolean, Boolean) Metódus

Definíció

Névtér:
System
Szerelvény:
mscorlib.dll
Szerelvény:
netstandard.dll

Lekéri a Type megadott nevet, megadva, hogy kis- és nagybetűkre érzékeny keresést hajt-e végre, és hogy kivételt adjon-e ki, ha a típus nem található. A típus csak tükröződésre van betöltve, végrehajtásra nem.

public:
 static Type ^ ReflectionOnlyGetType(System::String ^ typeName, bool throwIfNotFound, bool ignoreCase);
public static Type ReflectionOnlyGetType(string typeName, bool throwIfNotFound, bool ignoreCase);
static member ReflectionOnlyGetType : string * bool * bool -> Type
Public Shared Function ReflectionOnlyGetType (typeName As String, throwIfNotFound As Boolean, ignoreCase As Boolean) As Type

Paraméterek

typeName
String

A lekéréshez tartozó szerelvény-minősített név Type .

throwIfNotFound
Boolean

trueha a típus nem található, false akkor a TypeLoadException visszatérésheznull, ha a típus nem található. A beállítás false néhány egyéb kivételfeltételt is letilt, de nem mindegyiket. Lásd a Kivételek szakaszt.

ignoreCase
Boolean

true kis- és nagybetűk megkülönböztetésére szolgáló keresés typeNamevégrehajtása; false a kis- és nagybetűk megkülönböztetésére szolgáló keresés végrehajtásához typeName.

Válaszok

Type

A megadott névvel rendelkező típus, ha megtalálható; egyéb esetben. null Ha a típus nem található, a throwIfNotFound paraméter megadja, hogy a rendszer visszaadja-e null a hibát, vagy kivételt jelez. Bizonyos esetekben a rendszer kivételt vet ki, függetlenül az értéktől throwIfNotFound. Lásd a Kivételek szakaszt.

Kivételek

ArgumentNullException

typeName az null.

TargetInvocationException

A rendszer meghív egy osztály inicializálót, és kivételt jelez.

TypeLoadException

throwIfNotFound és true a típus nem található.

-vagy-

throwIfNotFound typeName érvénytelen true karaktereket tartalmaz, például beágyazott lapot.

-vagy-

throwIfNotFound typeName üres true sztring.

-vagy-

throwIfNotFound typeName érvénytelen true méretű tömbtípust jelöl.

-vagy-

typeName objektumtömböt TypedReference jelöl.

ArgumentException

typeName nem tartalmazza a szerelvény nevét.

-vagy-

throwIfNotFound typeName érvénytelen true szintaxist tartalmaz, például "MyType[,*;]".

-vagy-

typeName olyan általános típust jelöl, amely mutatótípussal, ByRef típussal vagy Void annak egyik típusargumentumaként rendelkezik.

-vagy-

typeName olyan általános típust jelöl, amely helytelen számú típusargumentummal rendelkezik.

-vagy-

typeName egy általános típust jelöl, és az egyik típusargumentum nem felel meg a megfelelő típusparaméter korlátainak.

FileNotFoundException

throwIfNotFound van, true és a szerelvény vagy annak egyik függősége nem található.

FileLoadException

A szerelvény vagy annak egyik függősége megtalálható, de nem tölthető be.

BadImageFormatException

A szerelvény vagy annak egyik függősége nem érvényes szerelvény az aktuálisan betöltött futtatókörnyezethez.

PlatformNotSupportedException

.NET Core és .NET 5+ csak: Minden esetben.

Megjegyzések

Ha a típust tartalmazó szerelvény még nincs betöltve a csak tükröződési környezetbe, a ReflectionOnlyGetType metódus használata egyenértékű azzal, hogy először csak tükröződés céljából tölti be a szerelvényt a ReflectionOnlyLoad metódus használatával, majd betölti a típust a szerelvény metódusának meghívásával Assembly.GetType . A szerelvény által minősített nevekről a tulajdonságban Type.AssemblyQualifiedName talál további információt. A típusnevek megadásával kapcsolatos további részletekért lásd a metódus túlterhelését GetType(String, Boolean, Boolean) .

Ha a szerelvény már be van töltve a végrehajtáshoz, a rendszer egy másik példányt tölt be a csak tükrözési környezetbe.

A throwIfNotFound paraméter megadja, hogy mi történik, ha a típus nem található, és letilt bizonyos egyéb kivételfeltételeket is, a Kivételek szakaszban leírtak szerint. Néhány kivételt a rendszer a megadott értéktől throwIfNotFoundfüggetlenül ad ki. Ha például a szerelvény érvénytelen, akkor a parancs akkor is megjelenik, BadImageFormatException ha throwIfNotFound igen false.

A csak tükrözési környezet használatáról további információt a Szerelvények betöltése a Reflection-Only környezetbe című témakörben talál.

A következőre érvényes:

Lásd még