Module.GetType Метод

Ссылка

Определение

Пространство имен:: System.Reflection

Сборка:: System.Runtime.dll

Сборка:: System.Reflection.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

GetType(String)	Возвращает заданный тип (выполняет поиск с учетом регистра).
GetType(String, Boolean)	Возвращает указанный тип, выполняя поиск в модуле с заданным требованием к учету регистра.
GetType(String, Boolean, Boolean)	Возвращает указанный тип, определяя, следует ли учитывать регистр при поиске модуля и должно ли создаваться исключение, если не удалось обнаружить этот тип.

GetType(String)

Исходный код:: Module.cs

Исходный код:: Module.cs

Исходный код:: 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)

Исходный код:: Module.cs

Исходный код:: Module.cs

Исходный код:: 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

Атрибуты: ComVisibleAttribute

Исключения

ArgumentNullException

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

TargetInvocationException

Вызываются инициализаторы класса и создается исключение.

ArgumentException

className представляет собой строку нулевой длины.

FileNotFoundException

Для className требуется зависимая сборка, которую не удалось найти.

FileLoadException

Для className требуется зависимая сборка, которая была найдена, но ее не удалось загрузить.

-или-

BadImageFormatException

Для className требуется зависимая сборка, однако файл не является допустимой сборкой.

-или-

Примеры

В следующем примере отображается имя типа в указанном модуле с указанием falseignoreCase параметра , чтобы регистр не пропускался.

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)

Исходный код:: Module.cs

Исходный код:: Module.cs

Исходный код:: 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 требуется зависимая сборка, которая была найдена, но ее не удалось загрузить.

-или-

BadImageFormatException

Для className требуется зависимая сборка, однако файл не является допустимой сборкой.

-или-

Примеры

В следующем примере отображается имя типа в указанном модуле. Параметры throwOnError и 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 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)

Параметры

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

Исключения

Примеры

Комментарии

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

Дополнительные ресурсы