Type.ReflectionOnlyGetType(String, Boolean, Boolean) Methode

Definitie

Naamruimte:
System
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Hiermee haalt u de Type met de opgegeven naam op en geeft u op of een hoofdlettergevoelige zoekopdracht moet worden uitgevoerd en of er een uitzondering moet worden gegenereerd als het type niet wordt gevonden. Het type wordt alleen geladen voor weerspiegeling, niet voor uitvoering.

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

Parameters

typeName
String

De assembly-gekwalificeerde naam van de Type te verkrijgen.

throwIfNotFound
Boolean

true als u een TypeLoadException als het type niet kan vinden; false om terug te keren null als het type niet kan worden gevonden. false Als u opgeeft, worden ook enkele andere uitzonderingsvoorwaarden onderdrukt, maar niet allemaal. Zie de sectie Uitzonderingen.

ignoreCase
Boolean

trueom een niet-hoofdlettergevoelige zoekopdracht typeNameuit te voeren ; false om een hoofdlettergevoelige zoekopdracht uit te voeren.typeName

Retouren

Type

Het type met de opgegeven naam, indien gevonden; anders, null. Als het type niet wordt gevonden, geeft de throwIfNotFound parameter aan of null deze wordt geretourneerd of er een uitzondering wordt gegenereerd. In sommige gevallen wordt er een uitzondering gegenereerd, ongeacht de waarde van throwIfNotFound. Zie de sectie Uitzonderingen.

Uitzonderingen

ArgumentNullException

typeName is null.

TargetInvocationException

Er wordt een klasse-initializer aangeroepen en er wordt een uitzondering gegenereerd.

TypeLoadException

throwIfNotFound is true en het type is niet gevonden.

– of –

throwIfNotFound is true en typeName bevat ongeldige tekens, zoals een ingesloten tabblad.

– of –

throwIfNotFound is true en typeName is een lege tekenreeks.

– of –

throwIfNotFound is true en typeName vertegenwoordigt een matrixtype met een ongeldige grootte.

– of –

typeName vertegenwoordigt een matrix met TypedReference objecten.

ArgumentException

typeName bevat niet de assemblynaam.

– of –

throwIfNotFound is true en typeName bevat een ongeldige syntaxis, bijvoorbeeld 'MyType[,*,]'.

– of –

typeName vertegenwoordigt een algemeen type met een type aanwijzer, een ByRef type of Void als een van de bijbehorende typeargumenten.

– of –

typeName vertegenwoordigt een algemeen type met een onjuist aantal typeargumenten.

– of –

typeName vertegenwoordigt een algemeen type en een van de bijbehorende typeargumenten voldoet niet aan de beperkingen voor de bijbehorende typeparameter.

FileNotFoundException

throwIfNotFound is true en de assembly of een van de bijbehorende afhankelijkheden is niet gevonden.

FileLoadException

De assembly of een van de bijbehorende afhankelijkheden is gevonden, maar kan niet worden geladen.

BadImageFormatException

De assembly of een van de afhankelijkheden is geen geldige assembly voor de momenteel geladen runtime.

PlatformNotSupportedException

.NET Core en .NET 5+ alleen: in alle gevallen.

Opmerkingen

Als de assembly met het type nog niet is geladen in de context alleen weerspiegeling, is het gebruik van de ReflectionOnlyGetType methode gelijk aan het laden van de assembly alleen voor weerspiegeling, met behulp van de ReflectionOnlyLoad methode en laadt u vervolgens het type door de methode van Assembly.GetType de assembly aan te roepen. Zie de Type.AssemblyQualifiedName eigenschap voor informatie over assembly-gekwalificeerde namen. Zie de overbelasting van de methode voor meer informatie over het GetType(String, Boolean, Boolean) opgeven van typenamen.

Als de assembly al is geladen voor uitvoering, wordt een andere kopie geladen in de context alleen voor weerspiegeling.

De throwIfNotFound parameter geeft aan wat er gebeurt wanneer het type niet wordt gevonden en onderdrukt ook bepaalde andere uitzonderingsvoorwaarden, zoals beschreven in de sectie Uitzonderingen. Sommige uitzonderingen worden gegenereerd, ongeacht de waarde van throwIfNotFound. Als de assembly bijvoorbeeld niet geldig is, wordt er een BadImageFormatException gegenereerd, zelfs als throwIfNotFound dat het is false.

Zie How to: Load Assembly's in the Reflection-Only Context voor meer informatie over het gebruik van de context die alleen voor reflectie geldt.

Van toepassing op

Zie ook