Module.GetType Méthode

Définition

Espace de noms:: System.Reflection

Assembly:: mscorlib.dll

Assembly:: System.Reflection.dll

Assembly:: netstandard.dll

Assemblys:: mscorlib.dll, System.Reflection.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne le type spécifié.

Surcharges

Nom	Description
GetType(String)	Retourne le type spécifié, effectuant une recherche sensible à la casse.
GetType(String, Boolean)	Retourne le type spécifié, en recherchant le module avec la sensibilité de casse spécifiée.
GetType(String, Boolean, Boolean)	Retourne le type spécifié, en spécifiant s’il faut effectuer une recherche sensible à la casse du module et s’il faut lever une exception si le type est introuvable.

GetType(String)

Retourne le type spécifié, effectuant une recherche sensible à la casse.

public:
 virtual Type ^ GetType(System::String ^ className);

public virtual Type GetType(string className);

[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType(string className);

override this.GetType : string -> Type

[<System.Runtime.InteropServices.ComVisible(true)>]
override this.GetType : string -> Type

Public Overridable Function GetType (className As String) As Type

Paramètres

className: String

Nom du type à localiser. Le nom doit être complet avec l’espace de noms.

Retours

Type

Objet Type représentant le type donné, si le type se trouve dans ce module ; sinon, null.

Attributs: ComVisibleAttribute

Exceptions

ArgumentNullException

className a la valeur null.

TargetInvocationException

Les initialiseurs de classe sont appelés et une exception est levée.

ArgumentException

className est une chaîne de longueur nulle.

FileNotFoundException

className nécessite un assembly dépendant qui n’a pas pu être trouvé.

FileLoadException

className 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 de réflexion uniquement et className nécessite un assembly dépendant qui n’a pas été préchargé.

BadImageFormatException

className nécessite un assembly dépendant, mais le fichier n’est pas un assembly valide.

-ou-

className nécessite un assembly dépendant qui a été compilé pour une version du runtime ultérieure à la version actuellement chargée.

Exemples

L’exemple suivant affiche le nom d’un type dans le module spécifié.

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing these classes.
            Module myModule = moduleArray[0];

            Type myType;

            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass");
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}

Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing these classes.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type

            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass")
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Remarques

Note

Si le type a été transféré à 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 Common Language Runtime.

Un type peut être récupéré à partir d’un module spécifique à l’aide Module.GetTypede . L’appel Module.GetType sur le module qui contient le manifeste ne recherche pas l’assembly entier. Pour récupérer un type à partir d’un assembly, quel que soit le module dans lequel il se trouve, vous devez appeler Assembly.GetType.

S’applique à

GetType(String, Boolean)

Retourne le type spécifié, en recherchant le module avec la sensibilité de casse spécifiée.

public:
 virtual Type ^ GetType(System::String ^ className, bool ignoreCase);

public virtual Type GetType(string className, bool ignoreCase);

[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType(string className, bool ignoreCase);

override this.GetType : string * bool -> Type

[<System.Runtime.InteropServices.ComVisible(true)>]
override this.GetType : string * bool -> Type

Public Overridable Function GetType (className As String, ignoreCase As Boolean) As Type

Paramètres

className: String

Nom du type à localiser. Le nom doit être complet avec l’espace de noms.

ignoreCase: Boolean

true pour la recherche sans respect de la casse ; sinon, false.

Retours

Type

Objet Type représentant le type donné, si le type se trouve dans ce module ; sinon, null.

Attributs: ComVisibleAttribute

Exceptions

ArgumentNullException

className a la valeur null.

TargetInvocationException

Les initialiseurs de classe sont appelés et une exception est levée.

ArgumentException

className est une chaîne de longueur nulle.

FileNotFoundException

className nécessite un assembly dépendant qui n’a pas pu être trouvé.

FileLoadException

className 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 de réflexion uniquement et className nécessite un assembly dépendant qui n’a pas été préchargé.

BadImageFormatException

className nécessite un assembly dépendant, mais le fichier n’est pas un assembly valide.

-ou-

className nécessite un assembly dépendant qui a été compilé pour une version du runtime ultérieure à la version actuellement chargée.

Exemples

L’exemple suivant affiche le nom d’un type dans le module spécifié, en spécifiant false pour le paramètre afin que ce ignoreCase cas ne soit pas ignoré.

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing these classes.
            Module myModule = moduleArray[0];

            Type myType;
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", false);
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}

Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing these classes.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", False)
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Remarques

Note

S’applique à

GetType(String, Boolean, Boolean)

Retourne le type spécifié, en spécifiant s’il faut effectuer une recherche sensible à la casse du module et s’il faut lever une exception si le type est introuvable.

public:
 virtual Type ^ GetType(System::String ^ className, bool throwOnError, bool ignoreCase);

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

[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType(string className, bool throwOnError, bool ignoreCase);

override this.GetType : string * bool * bool -> Type

[<System.Runtime.InteropServices.ComVisible(true)>]
override this.GetType : string * bool * bool -> Type

Public Overridable Function GetType (className As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Paramètres

className: String

Nom du type à localiser. Le nom doit être complet avec l’espace de noms.

throwOnError: Boolean

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

ignoreCase: Boolean

true pour la recherche sans respect de la casse ; sinon, false.

Retours

Type

Objet Type représentant le type spécifié, si le type est déclaré dans ce module ; sinon, null.

Attributs: ComVisibleAttribute

Exceptions

ArgumentNullException

className a la valeur null.

TargetInvocationException

Les initialiseurs de classe sont appelés et une exception est levée.

ArgumentException

className est une chaîne de longueur nulle.

TypeLoadException

throwOnError est true, et le type est introuvable.

FileNotFoundException

className nécessite un assembly dépendant qui n’a pas pu être trouvé.

FileLoadException

className 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 de réflexion uniquement et className nécessite un assembly dépendant qui n’a pas été préchargé.

BadImageFormatException

className nécessite un assembly dépendant, mais le fichier n’est pas un assembly valide.

-ou-

className nécessite un assembly dépendant qui a été compilé pour une version du runtime ultérieure à la version actuellement chargée.

Exemples

L’exemple suivant affiche le nom d’un type dans le module spécifié. Les throwOnError paramètres et ignoreCase les paramètres sont spécifiés en tant que false.

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing this class.
            Module myModule = moduleArray[0];

            Type myType;
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", false, false);
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}

Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing this class.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", False, False)
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Remarques

Le throwOnError paramètre affecte uniquement ce qui se passe lorsque le type est introuvable. Elle n’affecte aucune autre exception susceptible d’être levée. En particulier, si le type est trouvé mais ne peut pas être chargé, TypeLoadException peut être levée même si c’est throwOnErrorfalse.

Note

S’applique à

Commentaires

Cette page a-t-elle été utile ?