Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Type.ReflectionOnlyGetType, méthode

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.

ExceptionCondition
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 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 dont la taille est 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 un type 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 l'un de ses arguments de type ne satisfait pas les contraintes spécifiées 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 l'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 valide.

ou

L'assembly a été compilé avec une version du Common Language Runtime ulté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'utilisation de la méthode ReflectionOnlyGetType équivaut à charger d'abord l'assembly pour la réflexion uniquement, à utiliser la méthode ReflectionOnlyLoad, puis à charger le type en appelant la méthode Assembly.GetType de l'assembly. Pour plus d'informations sur les noms qualifiés d'assembly, consultez la propriété Type.AssemblyQualifiedName. Pour plus d'informations sur la spécification de noms de types, consultez la surcharge de méthode GetType(String, Boolean, Boolean).

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 paramètre throwIfNotFound spécifie ce qui arrive 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 indépendamment de la valeur de throwIfNotFound. Par exemple, si l'assembly n'est pas valide, un BadImageFormatException est levé même si throwIfNotFound a la valeur false.

Pour plus d'informations sur l'utilisation du contexte de réflexion uniquement, consultez Comment : charger des assemblys dans le contexte de réflexion uniquement.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft