Module.GetType Метод

Определение

Возвращает указанный тип.Returns the specified type.

Перегрузки

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)

Возвращает заданный тип (выполняет поиск с учетом регистра).Returns the specified type, performing a case-sensitive search.

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

Имя искомого типа.The name of the type to locate. Имя должно содержать пространство имен.The name must be fully qualified with the namespace.

Возвращаемое значение

Type

Объект Type, представляющий указанный тип, если тип находится в этом модуле. В противном случае возвращается значение null.A Type object representing the given type, if the type is in this module; otherwise, null.

Атрибуты

Исключения

className имеет значение null.className is null.

Вызываются инициализаторы класса и создается исключение.The class initializers are invoked and an exception is thrown.

className представляет собой строку нулевой длины.className is a zero-length string.

Для className требуется зависимая сборка, которую не удалось найти.className requires a dependent assembly that could not be found.

Для className требуется зависимая сборка, которая была найдена, но ее не удалось загрузить.className requires a dependent assembly that was found but could not be loaded.

-или--or- Текущая сборка была загружена в контекст только для отражения, а для className требуется зависимая сборка, которая не была предварительно загружена.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

Для className требуется зависимая сборка, однако файл не является допустимой сборкой.className requires a dependent assembly, but the file is not a valid assembly.

-или--or- Для className требуется зависимая сборка, которая была скомпилирована для версии среды выполнения более поздней, чем текущая загруженная версия.className requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Примеры

В следующем примере показано имя типа в указанном модуле.The following example displays the name of a type in the specified module.

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

Комментарии

Примечание

Если тип был перенаправлен другой сборке, он по-прежнему возвращается этим методом.If the type has been forwarded to another assembly, it is still returned by this method. Дополнительные сведения о пересылке типов см. в разделе Пересылка типов в среде CLR.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

Тип можно получить из определенного модуля с помощью Module.GetType .A type can be retrieved from a specific module using Module.GetType. Вызов Module.GetType для модуля, содержащего манифест, не будет выполнять поиск во всей сборке.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Чтобы получить тип из сборки, независимо от того, в каком модуле он находится, необходимо вызвать Assembly.GetType .To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

Применяется к

GetType(String, Boolean)

Возвращает указанный тип, выполняя поиск в модуле с заданным требованием к учету регистра.Returns the specified type, searching the module with the specified case sensitivity.

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

Имя искомого типа.The name of the type to locate. Имя должно содержать пространство имен.The name must be fully qualified with the namespace.

ignoreCase
Boolean

Значение true для поиска без учета регистра. В противном случае используется значение false.true for case-insensitive search; otherwise, false.

Возвращаемое значение

Type

Объект Type, представляющий указанный тип, если тип находится в этом модуле. В противном случае возвращается значение null.A Type object representing the given type, if the type is in this module; otherwise, null.

Атрибуты

Исключения

className имеет значение null.className is null.

Вызываются инициализаторы класса и создается исключение.The class initializers are invoked and an exception is thrown.

className представляет собой строку нулевой длины.className is a zero-length string.

Для className требуется зависимая сборка, которую не удалось найти.className requires a dependent assembly that could not be found.

Для className требуется зависимая сборка, которая была найдена, но ее не удалось загрузить.className requires a dependent assembly that was found but could not be loaded.

-или--or- Текущая сборка была загружена в контекст только для отражения, а для className требуется зависимая сборка, которая не была предварительно загружена.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

Для className требуется зависимая сборка, однако файл не является допустимой сборкой.className requires a dependent assembly, but the file is not a valid assembly.

-или--or- Для className требуется зависимая сборка, которая была скомпилирована для версии среды выполнения более поздней, чем текущая загруженная версия.className requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Примеры

В следующем примере выводится имя типа в указанном модуле, в котором указывается false значение для ignoreCase параметра, чтобы регистр не проигнорировался.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 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

Комментарии

Примечание

Если тип был перенаправлен другой сборке, он по-прежнему возвращается этим методом.If the type has been forwarded to another assembly, it is still returned by this method. Дополнительные сведения о пересылке типов см. в разделе Пересылка типов в среде CLR.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

Тип можно получить из определенного модуля с помощью Module.GetType .A type can be retrieved from a specific module using Module.GetType. Вызов Module.GetType для модуля, содержащего манифест, не будет выполнять поиск во всей сборке.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Чтобы получить тип из сборки, независимо от того, в каком модуле он находится, необходимо вызвать Assembly.GetType .To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

Применяется к

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.

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

Имя искомого типа.The name of the type to locate. Имя должно содержать пространство имен.The name must be fully qualified with the namespace.

throwOnError
Boolean

Значение true, чтобы создать исключение, если тип не удается найти; значение false, чтобы вернуть значение null.true to throw an exception if the type cannot be found; false to return null.

ignoreCase
Boolean

Значение true для поиска без учета регистра. В противном случае используется значение false.true for case-insensitive search; otherwise, false.

Возвращаемое значение

Type

Объект Type, представляющий указанный тип, если тип был объявлен в этом модуле; в противном случае — null.A Type object representing the specified type, if the type is declared in this module; otherwise, null.

Атрибуты

Исключения

className имеет значение null.className is null.

Вызываются инициализаторы класса и создается исключение.The class initializers are invoked and an exception is thrown.

className представляет собой строку нулевой длины.className is a zero-length string.

throwOnError является true, не удается найти тип.throwOnError is true, and the type cannot be found.

Для className требуется зависимая сборка, которую не удалось найти.className requires a dependent assembly that could not be found.

Для className требуется зависимая сборка, которая была найдена, но ее не удалось загрузить.className requires a dependent assembly that was found but could not be loaded.

-или--or- Текущая сборка была загружена в контекст только для отражения, а для className требуется зависимая сборка, которая не была предварительно загружена.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

Для className требуется зависимая сборка, однако файл не является допустимой сборкой.className requires a dependent assembly, but the file is not a valid assembly.

-или--or- Для className требуется зависимая сборка, которая была скомпилирована для версии среды выполнения более поздней, чем текущая загруженная версия.className requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Примеры

В следующем примере показано имя типа в указанном модуле.The following example displays the name of a type in the specified module. Параметры и задаются throwOnError ignoreCase как false .The throwOnError and ignoreCase parameters are specified as 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Параметр влияет только на то, что происходит, если тип не найден.The throwOnError parameter affects only what happens when the type is not found. Он не влияет на другие исключения, которые могут возникать.It does not affect any other exceptions that might be thrown. В частности, если тип найден, но не может быть загружен, TypeLoadException может возникнуть исключение, даже если throwOnError имеет значение false .In particular, if the type is found but cannot be loaded, TypeLoadException can be thrown even if throwOnError is false.

Примечание

Если тип был перенаправлен другой сборке, он по-прежнему возвращается этим методом.If the type has been forwarded to another assembly, it is still returned by this method. Дополнительные сведения о пересылке типов см. в разделе Пересылка типов в среде CLR.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

Тип можно получить из определенного модуля с помощью Module.GetType .A type can be retrieved from a specific module using Module.GetType. Вызов Module.GetType для модуля, содержащего манифест, не будет выполнять поиск во всей сборке.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Чтобы получить тип из сборки, независимо от того, в каком модуле он находится, необходимо вызвать Assembly.GetType .To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

Применяется к