Type.ReflectionOnlyGetType(String, Boolean, Boolean) Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

Type.cs

Upozornění

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Type Získá se zadaným názvem, určuje, zda se má provést vyhledávání s rozlišováním velkých a malých písmen a zda se má vyvolat výjimka, pokud typ nebyl nalezen. Typ se načte pouze pro reflexi, nikoli pro spuštění.

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

Parametry

typeName

String

Název sestavení, který Type chcete získat.

throwIfNotFound

Boolean

true pro vyvolání TypeLoadException typu, pokud typ nebyl nalezen. false Chcete-li se vrátit null , pokud typ nebyl nalezen. Zadání false také potlačí některé další podmínky výjimky, ale ne všechny. Viz část Výjimky.

ignoreCase

Boolean

true k provedení vyhledávání typeNamebez rozlišování velkých a malých písmen ; false k provedení vyhledávání typeNames rozlišováním malých a velkých písmen .

Návraty

Type

Typ se zadaným názvem, pokud byl nalezen; v opačném případě . null Pokud typ nebyl nalezen, parametr určuje, throwIfNotFound zda null je vrácen nebo je vyvolán výjimka. V některých případech je vyvolán výjimka bez ohledu na hodnotu .throwIfNotFound Viz část Výjimky.

Atributy

ObsoleteAttribute

Výjimky

ArgumentNullException

typeName je null.

TargetInvocationException

Inicializátor třídy je vyvolán a vyvolá výjimku.

TypeLoadException

throwIfNotFound je true a typ nebyl nalezen.

nebo

throwIfNotFound typeName obsahuje true neplatné znaky, například vloženou kartu.

nebo

throwIfNotFound je true prázdný typeName řetězec.

nebo

throwIfNotFound je true a typeName představuje typ pole s neplatnou velikostí.

nebo

typeName představuje pole TypedReference objektů.

ArgumentException

typeName neobsahuje název sestavení.

nebo

throwIfNotFound je true a typeName obsahuje neplatnou syntaxi, například MyType[,*,].

nebo

typeName představuje obecný typ, který má typ ukazatele, ByRef typ nebo Void jeden z argumentů typu.

nebo

typeName představuje obecný typ, který má nesprávný počet argumentů typu.

nebo

typeName představuje obecný typ a jeden z argumentů typu nevyhovuje omezením odpovídajícího parametru typu.

FileNotFoundException

throwIfNotFound je true a sestavení nebo jedna z jejích závislostí nebyla nalezena.

FileLoadException

Sestavení nebo jedna z jejích závislostí byla nalezena, ale nelze ji načíst.

BadImageFormatException

Sestavení nebo jedna z jejích závislostí není platným sestavením pro aktuálně načtený modul runtime.

PlatformNotSupportedException

Pouze .NET Core a .NET 5+ : Ve všech případech.

Poznámky

Pokud sestavení obsahující typ ještě není načteno do kontextu pouze reflexe, použití ReflectionOnlyGetType metody je ekvivalentní k prvnímu načtení sestavení pouze reflexe ReflectionOnlyLoad , pomocí metody a načtení typu voláním metody sestavení Assembly.GetType . Informace o kvalifikovaných názvech sestavení naleznete v vlastnosti Type.AssemblyQualifiedName . Další podrobnosti o zadávání názvů typů naleznete v GetType(String, Boolean, Boolean) přetížení metody.

Pokud je sestavení již načteno ke spuštění, další kopie je načtena do kontextu pouze reflexe.

Parametr throwIfNotFound určuje, co se stane, když se typ nenajde, a také potlačí určité další podmínky výjimky, jak je popsáno v části Výjimky. Některé výjimky jsou vyvolány bez ohledu na hodnotu .throwIfNotFound Například pokud sestavení není platné, vyvolá se i BadImageFormatException v případě , že throwIfNotFound je false.

Další informace o použití kontextu pouze reflexe naleznete v tématu Postupy: Načtení sestavení do Reflection-Only Kontext.

Viz také

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Zadání plně kvalifikovaných názvů typů
• Postupy: Načtení sestavení do kontextu Reflection-Only