Export (0) Print
Expand All

Assembly::GetType Method (String)

Gets the Type object with the specified name in the assembly instance.

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

public:
virtual Type^ GetType(
	String^ name
)

Parameters

name
Type: System::String

The full name of the type.

Return Value

Type: System::Type
An object that represents the specified class, or nullptr if the class is not found.

Implements

_Assembly::GetType(String)

ExceptionCondition
ArgumentException

name is invalid.

ArgumentNullException

name is nullptr.

FileNotFoundException

name requires a dependent assembly that could not be found.

FileLoadException
NoteNote

In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

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

-or-

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

BadImageFormatException

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

-or-

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

This method only searches the current assembly instance. The name parameter includes the namespace but not the assembly. To search other assemblies for a type, use the Type::GetType(String) method overload, which can optionally include an assembly display name as part of the type name.

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 defines an abstract MeansOfTransportation class in the Transportation namespace. It calls the GetType(String) method to retrieve its Type object, calls the Type::GetProperties method to get an array of PropertyInfo objects that represent the type's properties, and then displays information on the type's abstract properties. Note that the call to the GetType(String) method uses the type's fully qualified name (that is, its namespace along with its type name).

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

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 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft