Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

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

 

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.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

public static Type ReflectionOnlyGetType(
	string typeName,
	bool throwIfNotFound,
	bool ignoreCase
)

Paramètres

typeName
Type: System.String

Nom complet de l'assembly du Type à obtenir.

throwIfNotFound
Type: System.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
Type: System.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.

Valeur de retour

Type: System.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.

Exception Condition
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 une de ses dépendances n’est pas valide.

ou

L’assembly a été compilé avec une version du Common Language Runtime postérieure à la version actuellement chargée.

Si l’assembly contenant le type n’est pas déjà chargé dans le contexte de réflexion uniquement, à l’aide du ReflectionOnlyGetType méthode est équivalent au premier chargement de l’assembly pour la réflexion uniquement, à l’aide de la ReflectionOnlyLoad (méthode), puis le chargement du type en appelant l’assembly Assembly.GetType (méthode). 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 types, consultez le GetType(String, Boolean, Boolean) surcharge de 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 que se passe-t-il 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 le contexte de réflexion uniquement, consultez Comment : charger des assemblys dans le contexte de réflexion uniquement.

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: