Module.GetType 方法

参考

定义

命名空间:: System.Reflection

程序集:: System.Runtime.dll

程序集:: System.Reflection.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

返回指定的类型。

重载

GetType(String)	返回指定的类型，执行区分大小写的搜索。
GetType(String, Boolean)	返回指定的类型，通过指定的区分大小写搜索模块。
GetType(String, Boolean, Boolean)	返回指定的类型，指定是否对该模块进行区分大小写的搜索；如果找不到该类型，则指定是否引发异常。

GetType(String)

Source:: Module.cs

Source:: Module.cs

Source:: Module.cs

返回指定的类型，执行区分大小写的搜索。

public:
 virtual Type ^ GetType(System::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);

override this.GetType : string -> Type

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

Public Overridable Function GetType (className As String) As Type

参数

className: String

要查找的类型的名称。名称必须用命名空间加以完全限定。

Type

表示给定类型的 Type 对象（如果类型位于此模块中）；否则为 null。

属性: ComVisibleAttribute

例外

ArgumentNullException

className 为 null。

TargetInvocationException

调用类初始值设定项，并且引发异常。

ArgumentException

className 是一个长度为零的字符串。

FileNotFoundException

className 所需的从属程序集无法找到。

FileLoadException

className 所需的从属程序集已找到，但无法加载。

- 或 -

当前程序集被加载到仅反射上下文中，并且 className 所需的从属程序集未预先加载。

BadImageFormatException

className 需要一个从属程序集，但该文件不是有效的程序集。

- 或 -

className 需要一个从属程序集，该程序集已针对比当前加载的版本更高的运行时版本进行了编译。

示例

以下示例显示指定模块中类型的名称。

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->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 );
}

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

注解

注意

如果类型已转发到另一个程序集，此方法仍返回该类型。有关类型转发的信息，请参阅公共语言运行时中的类型转发。

可以使用从特定模块 Module.GetType检索类型。在包含清单的模块上调用 Module.GetType 不会搜索整个程序集。若要从程序集检索类型，无论它位于哪个模块中，都必须调用 Assembly.GetType。

适用于

GetType(String, Boolean)

Source:: Module.cs

Source:: Module.cs

Source:: Module.cs

返回指定的类型，通过指定的区分大小写搜索模块。

public:
 virtual Type ^ GetType(System::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);

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

参数

className: String

要查找的类型的名称。名称必须用命名空间加以完全限定。

ignoreCase: Boolean

对于不区分大小写的搜索，为 true；否则为 false。

Type

表示给定类型的 Type 对象（如果类型位于此模块中）；否则为 null。

属性: ComVisibleAttribute

例外

ArgumentNullException

className 为 null。

TargetInvocationException

调用类初始值设定项，并且引发异常。

ArgumentException

className 是一个长度为零的字符串。

FileNotFoundException

className 所需的从属程序集无法找到。

FileLoadException

className 所需的从属程序集已找到，但无法加载。

- 或 -

当前程序集被加载到仅反射上下文中，并且 className 所需的从属程序集未预先加载。

BadImageFormatException

className 需要一个从属程序集，但该文件不是有效的程序集。

- 或 -

className 需要一个从属程序集，该程序集已针对比当前加载的版本更高的运行时版本进行了编译。

示例

以下示例显示指定模块中的类型名称，为 ignoreCase 参数指定 false ，以便不会忽略大小写。

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->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 );
}

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

注解

注意

如果类型已转发到另一个程序集，此方法仍返回该类型。有关类型转发的信息，请参阅公共语言运行时中的类型转发。

适用于

GetType(String, Boolean, Boolean)

Source:: Module.cs

Source:: Module.cs

Source:: Module.cs

返回指定的类型，指定是否对该模块进行区分大小写的搜索；如果找不到该类型，则指定是否引发异常。

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

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.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

参数

className: String

要查找的类型的名称。名称必须用命名空间加以完全限定。

throwOnError: Boolean

如果为 true，则在找不到该类型时引发异常；如果为 false，则返回 null。

ignoreCase: Boolean

对于不区分大小写的搜索，为 true；否则为 false。

Type

如果已在此模块中声明指定类型，则为一个表示指定类型的 Type 对象；否则为 null。

属性: ComVisibleAttribute

例外

ArgumentNullException

className 为 null。

TargetInvocationException

调用类初始值设定项，并且引发异常。

ArgumentException

className 是一个长度为零的字符串。

TypeLoadException

throwOnError 为 true，且找不到此类型。

FileNotFoundException

className 所需的从属程序集无法找到。

FileLoadException

className 所需的从属程序集已找到，但无法加载。

- 或 -

当前程序集被加载到仅反射上下文中，并且 className 所需的从属程序集未预先加载。

BadImageFormatException

className 需要一个从属程序集，但该文件不是有效的程序集。

- 或 -

className 需要一个从属程序集，该程序集已针对比当前加载的版本更高的运行时版本进行了编译。

示例

以下示例显示指定模块中类型的名称。和 throwOnErrorignoreCase 参数指定为 false。

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->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 );
}

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

注解

参数 throwOnError 仅影响找不到类型时发生的情况。它不会影响可能引发的任何其他异常。具体而言，如果找到类型但无法加载， TypeLoadException 则即使 throwOnError 为 false，也可以引发。

注意

如果类型已转发到另一个程序集，此方法仍返回该类型。有关类型转发的信息，请参阅公共语言运行时中的类型转发。

适用于

通过

Module.GetType 方法

定义

重载

GetType(String)

参数

返回

例外

示例

注解

适用于

GetType(String, Boolean)

参数

返回

例外

示例

注解

适用于

GetType(String, Boolean, Boolean)

参数

返回

例外

示例

注解

适用于

其他资源