Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Module.GetType Method (String, Boolean, Boolean)

Returns the specified type, specifying whether to make a case-sensitive search of the module and whether to throw an exception if the type cannot be found.

Namespace: System.Reflection
Assembly: mscorlib (in mscorlib.dll)

[ComVisibleAttribute(true)] 
public virtual Type GetType (
	string className,
	bool throwOnError,
	bool ignoreCase
)
/** @attribute ComVisibleAttribute(true) */ 
public Type GetType (
	String className, 
	boolean throwOnError, 
	boolean ignoreCase
)
ComVisibleAttribute(true) 
public function GetType (
	className : String, 
	throwOnError : boolean, 
	ignoreCase : boolean
) : Type
Not applicable.

Parameters

className

The name of the type to locate. The name must be fully qualified with the namespace.

throwOnError

true to throw an exception if the type cannot be found; false to return a null reference (Nothing in Visual Basic).

ignoreCase

true for case-insensitive search; otherwise, false.

Return Value

A Type object representing the specified type, if the type is declared in this module; otherwise, a null reference (Nothing in Visual Basic).

Exception typeCondition

ArgumentNullException

className is a null reference (Nothing in Visual Basic).

TargetInvocationException

The class initializers are invoked and an exception is thrown.

ArgumentException

className is a zero-length string.

TypeLoadException

throwOnError is true, and the type cannot be found.

FileNotFoundException

className requires a dependent assembly that could not be found.

FileLoadException

className requires a dependent assembly that was found but could not be loaded.

-or-

The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

BadImageFormatException

className requires a dependent assembly, but the file is not a valid assembly.

-or-

className requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

The throwOnError parameter affects only what happens when the type is not found. It does not affect any other exceptions that might be thrown. In particular, if the type is found but cannot be loaded, TypeLoadException can be thrown even if throwOnError is false.

NoteNote:

If the type has been forwarded to another assembly, it is still returned by this method. For information on type forwarding, see Type Forwarding in the Common Language Runtime.

The following example displays the name of a type in the specified module. The throwOnError and ignoreCase parameters are specified as false.

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = Assembly.GetExecutingAssembly().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());
        }
    }
}

package ReflectionModule_Examples; 

import System.*;
import System.Reflection.*;

class MyMainClass
{

    public static void main(String[] args)
    {
        Module moduleArray[];
        moduleArray = Assembly.GetExecutingAssembly().GetModules(false);
        //In a simple project with only one module, the module at index
        // 0 will be the module containing this class.
        Module myModule = (Module)moduleArray.get_Item(0);
        Type myType;
        myType = myModule.GetType("ReflectionModule_Examples.MyMainClass",
            false, false);
        Console.WriteLine("Got type: {0}", myType.ToString());
    } //main
} //MyMainClass   

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

Show:
© 2015 Microsoft