Type.ReflectionOnlyGetType(String, Boolean, Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Achtung
ReflectionOnly loading is not supported and throws PlatformNotSupportedException.
Ruft den Type mit dem angegebenen Namen ab, der angibt, ob eine Suche mit Groß-/Kleinschreibung durchgeführt werden soll und ob eine Ausnahme ausgelöst werden soll, wenn der Typ nicht gefunden wird. Der Typ wird nur für Spiegelung geladen, nicht für die Ausführung.
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);public static Type? ReflectionOnlyGetType(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}")>]
static member ReflectionOnlyGetType : string * bool * bool -> Typestatic member ReflectionOnlyGetType : string * bool * bool -> TypePublic Shared Function ReflectionOnlyGetType (typeName As String, throwIfNotFound As Boolean, ignoreCase As Boolean) As TypeParameter
- throwIfNotFound
- Boolean
true um einen TypeLoadException Fehler auszuwerfen, wenn der Typ nicht gefunden werden kann; false um zurückzugeben null , wenn der Typ nicht gefunden werden kann. Die Angabe false unterdrückt auch einige andere Ausnahmebedingungen, aber nicht alle. Weitere Informationen finden Sie im Abschnitt "Ausnahmen".
- ignoreCase
- Boolean
trueum eine Suche ohne Groß-/Kleinschreibung durchzuführen; false um eine Suche typeNametypeNamenach Groß-/Kleinschreibung durchzuführen.
Gibt zurück
Der Typ mit dem angegebenen Namen, falls gefunden; andernfalls . null Wenn der Typ nicht gefunden wird, gibt der throwIfNotFound Parameter an, ob null zurückgegeben oder eine Ausnahme ausgelöst wird. In einigen Fällen wird unabhängig vom Wert einer throwIfNotFoundAusnahme eine Ausnahme ausgelöst. Weitere Informationen finden Sie im Abschnitt "Ausnahmen".
- Attribute
Ausnahmen
typeName ist null.
Ein Klasseninitialisierer wird aufgerufen und löst eine Ausnahme aus.
throwIfNotFound ist true und der Typ nicht gefunden wird.
- oder -
throwIfNotFound
typeName enthält true ungültige Zeichen, z. B. eine eingebettete Registerkarte.
- oder -
throwIfNotFound ist true eine typeName leere Zeichenfolge.
- oder -
throwIfNotFound ist true und typeName stellt einen Arraytyp mit einer ungültigen Größe dar.
- oder -
typeName stellt ein Array von TypedReference Objekten dar.
typeName enthält nicht den Assemblynamen.
- oder -
throwIfNotFound ist true und typeName enthält eine ungültige Syntax, z. B. "MyType[,*,]".
- oder -
typeName stellt einen generischen Typ dar, der einen Zeigertyp, einen ByRef Typ oder Void als eines seiner Typargumente enthält.
- oder -
typeName stellt einen generischen Typ dar, der über eine falsche Anzahl von Typargumenten verfügt.
- oder -
typeName stellt einen generischen Typ dar, und eines seiner Typargumente erfüllt nicht die Einschränkungen für den entsprechenden Typparameter.
throwIfNotFound ist true und die Assembly oder eine ihrer Abhängigkeiten nicht gefunden wurde.
Die Assembly oder eine ihrer Abhängigkeiten wurde gefunden, konnte aber nicht geladen werden.
Die Assembly oder eine ihrer Abhängigkeiten ist keine gültige Assembly für die derzeit geladene Laufzeit.
Nur .NET Core und .NET 5+ : In allen Fällen.
Hinweise
Wenn die Assembly, die den Typ enthält, noch nicht in den Spiegelungskontext geladen wird, entspricht die Verwendung der ReflectionOnlyGetType Methode dem ersten Laden der Assembly zur Spiegelung, wobei die ReflectionOnlyLoad Methode verwendet wird, und dann den Typ durch Aufrufen der Assemblymethode Assembly.GetType zu laden. Informationen zu assemblyqualifizierten Namen finden Sie in der Type.AssemblyQualifiedName Eigenschaft. Weitere Informationen zum Angeben von Typnamen finden Sie in der GetType(String, Boolean, Boolean) Methodenüberladung.
Wenn die Assembly bereits für die Ausführung geladen wurde, wird eine weitere Kopie in den Kontext "Reflection-only" geladen.
Der throwIfNotFound Parameter gibt an, was geschieht, wenn der Typ nicht gefunden wird, und unterdrückt auch bestimmte andere Ausnahmebedingungen, wie im Abschnitt "Ausnahmen" beschrieben. Einige Ausnahmen werden unabhängig vom Wert von throwIfNotFound. Wenn die Assembly z. B. ungültig ist, wird ein BadImageFormatException Fehler ausgelöst, auch wenn throwIfNotFound dies der Wert ist false.
Weitere Informationen zur Verwendung des reinen Spiegelungskontexts finden Sie unter How to: Load Assemblies into the Reflection-Only Context.
