Assembly.GetType Méthode

Définition

Espace de noms:

System.Reflection

Assembly:

System.Runtime.dll

Obtient l'objet Type qui représente le type spécifié.

Surcharges

GetType(String, Boolean, Boolean)	Obtient l'objet Type portant le nom spécifié dans l'instance de l'assembly et propose d'ignorer la casse et de lever une exception si le type est introuvable.
GetType(String, Boolean)	Obtient l'objet Type portant le nom spécifié dans l'instance de l'assembly et lève éventuellement une exception si le type est introuvable.
GetType(String)	Obtient l'objet Type avec le nom spécifié dans l'instance de l'assembly.

GetType(String, Boolean, Boolean)

Source:

Assembly.cs

Obtient l'objet Type portant le nom spécifié dans l'instance de l'assembly et propose d'ignorer la casse et de lever une exception si le type est introuvable.

C#

public virtual Type? GetType (string name, bool throwOnError, bool ignoreCase);

Paramètres

name

String

Nom complet du type.

throwOnError

Boolean

true pour lever une exception si le type est introuvable ; false pour retourner la valeur null.

ignoreCase

Boolean

true pour ignorer la casse du nom de type ; sinon, false.

Retours

Type

Objet qui représente la classe spécifiée.

Exceptions

ArgumentException

name n'est pas valide.

- ou -

La longueur de name dépasse 1 024 caractères.

ArgumentNullException

name a la valeur null.

TypeLoadException

throwOnError a la valeur true et le type est introuvable.

FileNotFoundException

name requiert un assembly dépendant qui est introuvable.

FileLoadException

name nécessite un assembly dépendant qui a été trouvé, mais qui n’a pas pu être chargé.

- ou -

L’assembly actuel a été chargé dans le contexte ReflectionOnly, et name nécessite un assembly dépendant qui n’a pas été préchargé.

BadImageFormatException

typeName nécessite un assembly dépendant, mais le fichier n’est pas un assembly valide pour le runtime actuellement chargé.

Remarques

Cette méthode recherche uniquement l’instance d’assembly actuelle. Le name paramètre inclut l’espace de noms, mais pas l’assembly. Pour rechercher un type dans d’autres assemblys, utilisez la Type.GetType(String) surcharge de méthode, qui peut éventuellement inclure un nom d’affichage d’assembly dans le nom de type.

Note

Si le type a été transféré vers un autre assembly, il est toujours retourné par cette méthode. Pour plus d’informations sur le transfert de type, consultez Transfert de type dans le Common Language Runtime.

Le throwOnError paramètre affecte uniquement ce qui se produit lorsque le type est introuvable. Elle n’affecte pas les autres exceptions qui peuvent être levées. En particulier, si le type est trouvé mais ne peut pas être chargé, TypeLoadException peut être levée même si throwOnError est false.

GetType(String, Boolean)

Source:

Assembly.cs

Obtient l'objet Type portant le nom spécifié dans l'instance de l'assembly et lève éventuellement une exception si le type est introuvable.

C#

public virtual Type? GetType (string name, bool throwOnError);

Paramètres

name

String

Nom complet du type.

throwOnError

Boolean

true pour lever une exception si le type est introuvable ; false pour retourner la valeur null.

Retours

Type

Objet qui représente la classe spécifiée.

Exceptions

ArgumentException

name n'est pas valide.

- ou -

La longueur de name dépasse 1 024 caractères.

ArgumentNullException

name a la valeur null.

TypeLoadException

throwOnError a la valeur true et le type est introuvable.

FileNotFoundException

name requiert un assembly dépendant qui est introuvable.

FileLoadException

name nécessite un assembly dépendant qui a été trouvé, mais qui n’a pas pu être chargé.

- ou -

L’assembly actuel a été chargé dans le contexte ReflectionOnly, et name nécessite un assembly dépendant qui n’a pas été préchargé.

BadImageFormatException

typeName nécessite un assembly dépendant, mais le fichier n’est pas un assembly valide pour le runtime actuellement chargé.

Remarques

Cette méthode recherche uniquement l’instance d’assembly actuelle. Le name paramètre inclut l’espace de noms, mais pas l’assembly. Pour rechercher un type dans d’autres assemblys, utilisez la Type.GetType(String) surcharge de méthode, qui peut éventuellement inclure un nom d’affichage d’assembly dans le nom de type.

Note

Si le type a été transféré vers un autre assembly, il est toujours retourné par cette méthode. Pour plus d’informations sur le transfert de type, consultez Transfert de type dans le Common Language Runtime.

Le throwOnError paramètre affecte uniquement ce qui se produit lorsque le type est introuvable. Elle n’affecte pas les autres exceptions qui peuvent être levées. En particulier, si le type est trouvé mais ne peut pas être chargé, TypeLoadException peut être levée même si throwOnError est false.

GetType(String)

Source:

Assembly.cs

Obtient l'objet Type avec le nom spécifié dans l'instance de l'assembly.

C#

public virtual Type? GetType (string name);

Paramètres

name

String

Nom complet du type.

Retours

Type

Objet qui représente la classe spécifiée ou null si la classe est introuvable.

Exceptions

ArgumentException

name n'est pas valide.

ArgumentNullException

name a la valeur null.

FileNotFoundException

name requiert un assembly dépendant qui est introuvable.

FileLoadException

name nécessite un assembly dépendant qui a été trouvé, mais qui n’a pas pu être chargé.

- ou -

L’assembly actuel a été chargé dans le contexte ReflectionOnly, et name nécessite un assembly dépendant qui n’a pas été préchargé.

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable, interceptez l’exception de la classe de base, IOException, à la place.

BadImageFormatException

typeName nécessite un assembly dépendant, mais le fichier n’est pas un assembly valide pour le runtime actuellement chargé.

Exemples

L’exemple suivant définit une classe abstraite MeansOfTransportation dans l’espace de Transportation noms. Il appelle la GetType(String) méthode pour récupérer son Type objet, appelle la Type.GetProperties méthode pour obtenir un tableau d’objets PropertyInfo qui représentent les propriétés du type, puis affiche des informations sur les propriétés abstraites du type. Notez que l’appel à la GetType(String) méthode utilise le nom complet du type (c’est-à-dire son espace de noms ainsi que son nom de type).

C#

using System;
using System.Reflection;

public class Example
{
    public static void Main()
    {
        Assembly assem = typeof(Example).Assembly;
        Type t = assem.GetType("Transportation.MeansOfTransportation");
        if (t != null)
        {
            Console.WriteLine($"Virtual properties in type {t.FullName}:");
            PropertyInfo[] props = t.GetProperties();
            int nVirtual = 0;
            for (int ctr = 0; ctr < props.Length; ctr++)
            {
                if (props[ctr].GetMethod.IsVirtual)
                {
                    Console.WriteLine($"   {props[ctr].Name} (type {props[ctr].PropertyType.FullName})");
                    nVirtual++;
                }
            }

            if (nVirtual == 0)
                Console.WriteLine("   No virtual properties");
        }
    }
}

namespace Transportation
{
    public abstract class MeansOfTransportation
    {
        abstract public bool HasWheels { get; set; }
        abstract public int Wheels { get; set; }
        abstract public bool ConsumesFuel { get; set; }
        abstract public bool Living { get; set; }
    }
}
// The example displays the following output:
//    Virtual properties in type Transportation.MeansOfTransportation:
//       HasWheels (type System.Boolean)
//       Wheels (type System.Int32)
//       ConsumesFuel (type System.Boolean)
//       Living (type System.Boolean)

Remarques

Cette méthode recherche uniquement l’instance d’assembly actuelle. Le name paramètre inclut l’espace de noms, mais pas l’assembly. Pour rechercher un type dans d’autres assemblys, utilisez la Type.GetType(String) surcharge de méthode, qui peut éventuellement inclure un nom d’affichage d’assembly dans le nom de type.

Note

Si le type a été transféré vers un autre assembly, il est toujours retourné par cette méthode. Pour plus d’informations sur le transfert de type, consultez Transfert de type dans le Common Language Runtime.