Module.GetType Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns the specified type.
Overloads
| GetType(String) |
Returns the specified type, performing a case-sensitive search. |
| GetType(String, Boolean) |
Returns the specified type, searching the module with the specified case sensitivity. |
| GetType(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. |
GetType(String)
- Source:
- Module.cs
- Source:
- Module.cs
- Source:
- Module.cs
- Source:
- Module.cs
Returns the specified type, performing a case-sensitive search.
public:
virtual Type ^ GetType(System::String ^ className);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed by trimming. If the type name is a string literal, consider using Type.GetType instead.")]
public virtual Type? GetType(string className);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed")]
public virtual Type? GetType(string className);public virtual Type GetType(string className);public virtual Type? GetType(string className);[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType(string className);[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed by trimming. If the type name is a string literal, consider using Type.GetType instead.")>]
override this.GetType : string -> Type[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed")>]
override this.GetType : string -> Typeoverride this.GetType : string -> Type[<System.Runtime.InteropServices.ComVisible(true)>]
override this.GetType : string -> TypePublic Overridable Function GetType (className As String) As TypeParameters
- className
- String
The name of the type to locate. The name must be fully qualified with the namespace.
Returns
A Type object representing the given type, if the type is in this module; otherwise, null.
- Attributes
Exceptions
className is null.
The class initializers are invoked and an exception is thrown.
className is a zero-length string.
className requires a dependent assembly that could not be found.
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.
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.
Examples
The following example displays the name of a type in the specified module.
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
Remarks
Note
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.
A type can be retrieved from a specific module using Module.GetType. Calling Module.GetType on the module that contains the manifest will not search the entire assembly. To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.
Applies to
GetType(String, Boolean)
- Source:
- Module.cs
- Source:
- Module.cs
- Source:
- Module.cs
- Source:
- Module.cs
Returns the specified type, searching the module with the specified case sensitivity.
public:
virtual Type ^ GetType(System::String ^ className, bool ignoreCase);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed by trimming. If the type name is a string literal, consider using Type.GetType instead.")]
public virtual Type? GetType(string className, bool ignoreCase);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed")]
public virtual Type? GetType(string className, bool ignoreCase);public virtual Type GetType(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);[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed by trimming. If the type name is a string literal, consider using Type.GetType instead.")>]
override this.GetType : string * bool -> Type[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed")>]
override this.GetType : string * bool -> Typeoverride this.GetType : string * bool -> Type[<System.Runtime.InteropServices.ComVisible(true)>]
override this.GetType : string * bool -> TypePublic Overridable Function GetType (className As String, ignoreCase As Boolean) As TypeParameters
- className
- String
The name of the type to locate. The name must be fully qualified with the namespace.
- ignoreCase
- Boolean
true for case-insensitive search; otherwise, false.
Returns
A Type object representing the given type, if the type is in this module; otherwise, null.
- Attributes
Exceptions
className is null.
The class initializers are invoked and an exception is thrown.
className is a zero-length string.
className requires a dependent assembly that could not be found.
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.
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.
Examples
The following example displays the name of a type in the specified module, specifying false for the ignoreCase parameter so that case will not be ignored.
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
Remarks
Note
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.
A type can be retrieved from a specific module using Module.GetType. Calling Module.GetType on the module that contains the manifest will not search the entire assembly. To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.
Applies to
GetType(String, Boolean, Boolean)
- Source:
- Module.cs
- Source:
- Module.cs
- Source:
- Module.cs
- Source:
- Module.cs
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.
public:
virtual Type ^ GetType(System::String ^ className, bool throwOnError, bool ignoreCase);public virtual Type GetType(string className, bool throwOnError, bool ignoreCase);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed by trimming. If the type name is a string literal, consider using Type.GetType instead.")]
public virtual Type? GetType(string className, bool throwOnError, bool ignoreCase);[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed")]
public virtual Type? GetType(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.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed by trimming. If the type name is a string literal, consider using Type.GetType instead.")>]
override this.GetType : string * bool * bool -> Type[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types might be removed")>]
override this.GetType : string * bool * bool -> Type[<System.Runtime.InteropServices.ComVisible(true)>]
override this.GetType : string * bool * bool -> TypePublic Overridable Function GetType (className As String, throwOnError As Boolean, ignoreCase As Boolean) As TypeParameters
- className
- String
The name of the type to locate. The name must be fully qualified with the namespace.
- throwOnError
- Boolean
true to throw an exception if the type cannot be found; false to return null.
- ignoreCase
- Boolean
true for case-insensitive search; otherwise, false.
Returns
A Type object representing the specified type, if the type is declared in this module; otherwise, null.
- Attributes
Exceptions
className is null.
The class initializers are invoked and an exception is thrown.
className is a zero-length string.
throwOnError is true, and the type cannot be found.
className requires a dependent assembly that could not be found.
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.
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.
Examples
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 = 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
Remarks
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.
Note
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.
A type can be retrieved from a specific module using Module.GetType. Calling Module.GetType on the module that contains the manifest will not search the entire assembly. To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.
