Type.ReflectionOnlyGetType(String, Boolean, Boolean) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

Type.cs

Attention

ReflectionOnly loading is not supported and throws PlatformNotSupportedException.

Obtient le Type portant le nom spécifié, indiquant s'il faut effectuer une recherche respectant la casse et lever une exception si le type est introuvable. Le type est chargé dans un contexte de réflexion, et non d'exécution.

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

Paramètres

typeName

String

Nom complet de l'assembly du Type à obtenir.

throwIfNotFound

Boolean

true pour lever une TypeLoadException si le type est introuvable ; false pour retourner null si le type est introuvable. false supprime également d'autres conditions d'exception, mais pas toutes. Consultez la section Exceptions.

ignoreCase

Boolean

true pour effectuer une recherche qui ne respecte pas la casse de typeName et false pour effectuer une recherche qui respecte la casse de typeName.

Retours

Type

Type présentant le nom spécifié, s'il est trouvé ; sinon, null. Si le type est introuvable, le paramètre throwIfNotFound spécifie si null est retourné ou bien une exception est levée. Dans certains cas, une exception est levée indépendamment de la valeur de throwIfNotFound. Consultez la section Exceptions.

Attributs

ObsoleteAttribute

Exceptions

ArgumentNullException

typeName a la valeur null.

TargetInvocationException

Un initialiseur de classe est appelé et lève une exception.

TypeLoadException

throwIfNotFound a la valeur true et le type est introuvable.

- ou -

throwIfNotFound a la valeur true et typeName contient des caractères non valides, tels qu’une tabulation incorporée.

- ou -

throwIfNotFound a la valeur true et typeName est une chaîne vide.

- ou -

throwIfNotFound a la valeur true et typeName représente un type de tableau avec une taille non valide.

- ou -

typeName représente un tableau d’objets TypedReference.

ArgumentException

typeName n’inclut pas le nom de l’assembly.

- ou -

throwIfNotFound a la valeur true et typeName contient une syntaxe non valide ; par exemple, « MyType[,*,] ».

- ou -

typeName représente un type générique qui a un type pointeur, un type ByRef ou Void comme l’un de ses arguments de type.

- ou -

typeName représente un type générique qui a un nombre incorrect d’arguments de type.

- ou -

typeName représente un type générique, et un de ses arguments de type ne satisfait pas aux contraintes pour le paramètre de type correspondant.

FileNotFoundException

throwIfNotFound a la valeur true, et l’assembly ou l’une de ses dépendances est introuvable.

FileLoadException

L’assembly ou une de ses dépendances a été trouvé, mais n’a pas pu être chargé.

BadImageFormatException

L’assembly ou l’une de ses dépendances n’est pas un assembly valide pour le runtime actuellement chargé.

PlatformNotSupportedException

.NET Core et .NET 5 (et versions ultérieures) uniquement : Dans tous les cas.

Remarques

Si l’assembly contenant le type n’est pas déjà chargé dans le contexte de réflexion uniquement, l’utilisation de la ReflectionOnlyGetType méthode revient à charger d’abord l’assembly pour la réflexion uniquement, à l’aide de la ReflectionOnlyLoad méthode, puis à charger le type en appelant la méthode de Assembly.GetType l’assembly. Pour plus d’informations sur les noms qualifiés d’assembly, consultez la Type.AssemblyQualifiedName propriété . Pour plus d’informations sur la spécification des noms de type, consultez la surcharge de GetType(String, Boolean, Boolean) méthode.

Si l’assembly est déjà chargé pour l’exécution, une autre copie est chargée dans le contexte de réflexion uniquement.

Le throwIfNotFound paramètre spécifie ce qui se produit lorsque le type est introuvable et supprime également certaines autres conditions d’exception, comme décrit dans la section Exceptions. Certaines exceptions sont levées quelle que soit la valeur de throwIfNotFound. Par exemple, si l’assembly n’est pas valide, un BadImageFormatException est levée même si throwIfNotFound est false.

Pour plus d’informations sur l’utilisation du contexte de réflexion uniquement, consultez Guide pratique pour charger des assemblys dans le contexte Reflection-Only.

Voir aussi

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Spécification des noms de types complets
• Guide pratique pour charger des assemblys dans le contexte de réflexion uniquement