Type.ReflectionOnlyGetType(String, Boolean, Boolean) Type.ReflectionOnlyGetType(String, Boolean, Boolean) Type.ReflectionOnlyGetType(String, Boolean, Boolean) Type.ReflectionOnlyGetType(String, Boolean, Boolean) Method

Definition

Ruft den Type mit dem angegebenen Namen ab. Dabei wird angegeben, ob bei der Suche die Groß- und Kleinschreibung berücksichtigt werden soll und ob eine Ausnahme ausgelöst werden soll, wenn der Typ nicht gefunden wird.Gets the Type with the specified name, specifying whether to perform a case-sensitive search and whether to throw an exception if the type is not found. Der Typ wird für die Reflektion, nicht für Ausführung geladen.The type is loaded for reflection only, not for execution.

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

Parameter

typeName
String String String String

Der durch die Assembly bezeichnete Name des abzurufenden Type.The assembly-qualified name of the Type to get.

throwIfNotFound
Boolean Boolean Boolean Boolean

true, damit eine TypeLoadException ausgelöst wird, wenn der Typ nicht gefunden wird. false, damit null zurückgegeben wird, wenn der Typ nicht gefunden wird.true to throw a TypeLoadException if the type cannot be found; false to return null if the type cannot be found. Die Angabe von false unterdrückt auch einige andere Ausnahmebedingungen, aber nicht alle.Specifying false also suppresses some other exception conditions, but not all of them. Informationen finden Sie im Abschnitt für Ausnahmen.See the Exceptions section.

ignoreCase
Boolean Boolean Boolean Boolean

true, um ohne Beachtung der Groß-/Kleinschreibung nach typeName zu suchen; false, um mit Beachtung der Groß-/Kleinschreibung nach typeName zu suchen.true to perform a case-insensitive search for typeName; false to perform a case-sensitive search for typeName.

Gibt zurück

Der Typ mit dem angegebenen Namen, sofern gefunden, andernfalls null.The type with the specified name, if found; otherwise, null. Wenn der Typ nicht gefunden wird, gibt der throwIfNotFound-Parameter an, ob null zurückgegeben oder eine Ausnahme ausgelöst wird.If the type is not found, the throwIfNotFound parameter specifies whether null is returned or an exception is thrown. In einigen Fällen wird unabhängig vom Wert von throwIfNotFound eine Ausnahme ausgelöst.In some cases, an exception is thrown regardless of the value of throwIfNotFound. Informationen finden Sie im Abschnitt für Ausnahmen.See the Exceptions section.

Ausnahmen

Ein Klasseninitialisierer wird aufgerufen und löst eine Ausnahme aus.A class initializer is invoked and throws an exception.

throwIfNotFound ist true, und der Typ wurde nicht gefunden.throwIfNotFound is true and the type is not found.

- oder --or- throwIfNotFound ist true, und typeName enthält ungültige Zeichen, z. B. ein eingebettetes Tabstoppzeichen.throwIfNotFound is true and typeName contains invalid characters, such as an embedded tab. - oder --or- throwIfNotFound ist true, und typeName ist eine leere Zeichenfolge.throwIfNotFound is true and typeName is an empty string.

- oder --or- throwIfNotFound ist true, und typeName stellt einen Arraytyp mit einer ungültigen Größe dar.throwIfNotFound is true and typeName represents an array type with an invalid size.

- oder --or- typeName stellt ein Array mit TypedReference-Objekten dar.typeName represents an array of TypedReference objects.

typeName enthält keinen Assemblynamen.typeName does not include the assembly name.

- oder --or- throwIfNotFound ist true, und typeName enthält ungültige Syntax (z.B. „MyType[,*,]“).throwIfNotFound is true and typeName contains invalid syntax; for example, "MyType[,*,]".

- oder --or- typeName stellt einen generischen Typ dar, der einen Zeigertyp, einen ByRef-Typ oder Void als eines seiner Typargumente aufweist.typeName represents a generic type that has a pointer type, a ByRef type, or Void as one of its type arguments.

- oder --or- typeName stellt einen generischen Typ dar, der eine falsche Anzahl von Typargumenten aufweist.typeName represents a generic type that has an incorrect number of type arguments.

- oder --or- typeName stellt einen generischen Typ dar, und eines seiner Typargumente erfüllt nicht die Einschränkungen für den entsprechenden Typparameter.typeName represents a generic type, and one of its type arguments does not satisfy the constraints for the corresponding type parameter.

throwIfNotFound ist true, und die Assembly oder eine der zugehörigen Abhängigkeiten wurde nicht gefunden.throwIfNotFound is true and the assembly or one of its dependencies was not found.

Die Assembly oder eine der zugehörigen Abhängigkeiten wurde gefunden, konnte aber nicht geladen werden.The assembly or one of its dependencies was found, but could not be loaded.

Die Assembly oder eine der zugehörigen Abhängigkeiten ist ungültig.The assembly or one of its dependencies is not valid.

- oder --or-

Die Assembly wurde mit einer Version der Common Language Runtime kompiliert, die höher ist als die Version, die derzeit geladen ist.The assembly was compiled with a later version of the common language runtime than the version that is currently loaded.

Nur .NET Core: Dieser Member wird nicht unterstützt..NET Core only: This member is not supported.

Hinweise

Wenn die Assembly, die den Typ enthält, nicht bereits in den Reflektionskontext geladen wurde ReflectionOnlyGetType , entspricht die Verwendung der-Methode dem ersten Laden der Assembly für die ReflectionOnlyLoad Reflektion, der Verwendung der-Methode und dem anschließenden Laden des Typs durch Aufrufen von. die- Assembly.GetType Methode der Assembly.If the assembly containing the type is not already loaded into the reflection-only context, using the ReflectionOnlyGetType method is equivalent to first loading the assembly for reflection only, using the ReflectionOnlyLoad method, and then loading the type by calling the assembly's Assembly.GetType method. Informationen zu qualifizierten Assemblynamen finden Sie unter Type.AssemblyQualifiedName der-Eigenschaft.For information about assembly-qualified names, see the Type.AssemblyQualifiedName property. Weitere Informationen zum Angeben von Typnamen finden Sie unter GetType(String, Boolean, Boolean) der-Methoden Überladung.For additional details on specifying type names, see the GetType(String, Boolean, Boolean) method overload.

Wenn die Assembly bereits zur Ausführung geladen ist, wird eine andere Kopie in den reflektionsbasierten Kontext geladen.If the assembly is already loaded for execution, another copy is loaded into the reflection-only context.

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.The throwIfNotFound parameter specifies what happens when the type is not found, and also suppresses certain other exception conditions, as described in the Exceptions section. Einige Ausnahmen werden unabhängig vom Wert von throwIfNotFoundausgelöst.Some exceptions are thrown regardless of the value of throwIfNotFound. Wenn die Assembly z. b. ungültig ist, wird BadImageFormatException eine ausgelöst, auch throwIfNotFound Wenn falseist.For example, if the assembly is not valid, a BadImageFormatException is thrown even if throwIfNotFound is false.

Weitere Informationen zur Verwendung des reflektionsbasierten Kontexts finden Sie unter Gewusst wie: Laden von Assemblys in den reflexionsbezogenen Kontext.For more information about using the reflection-only context, see How to: Load Assemblies into the Reflection-Only Context.

Gilt für:

Siehe auch