Поделиться через


Assembly.GetType Метод

Определение

Получает объект Type, представляющий указанный тип.

Перегрузки

GetType(String, Boolean, Boolean)

Возвращает объект Type с заданным именем в экземпляре сборки, с возможностями игнорировать регистр и вызвать исключение, если тип не найден.

GetType(String, Boolean)

Возвращает объект Type с заданным именем в экземпляре сборки и может вызывать исключение, если тип не найден.

GetType(String)

Возвращает объект Type с указанным именем в экземпляре сборки.

GetType()

GetType(String, Boolean, Boolean)

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

Возвращает объект Type с заданным именем в экземпляре сборки, с возможностями игнорировать регистр и вызвать исключение, если тип не найден.

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError, bool ignoreCase);
public virtual Type GetType (string name, bool throwOnError, bool ignoreCase);
public virtual Type? GetType (string name, bool throwOnError, bool ignoreCase);
public Type GetType (string name, bool throwOnError, bool ignoreCase);
override this.GetType : string * bool * bool -> Type
Public Overridable Function GetType (name As String, throwOnError As Boolean, ignoreCase As Boolean) As Type
Public Function GetType (name As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Параметры

name
String

Полное имя типа.

throwOnError
Boolean

Значение true для создания исключения, если тип не найден, в обратном случае — значение false, в результате чего будет возвращено значение null.

ignoreCase
Boolean

Значение true, чтобы игнорировать регистр имени типа, в обратном случае — значение false.

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

Объект, представляющий указанный класс.

Реализации

Исключения

name недопустим.

-или-

Длина name превышает 1024 символа.

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

throwOnError является true, не удается найти тип.

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

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

-или-

Текущая сборка была загружена в контекст только для отражения, а для name требуется зависимая сборка, которая не была предварительно загружена.

typeName Требуется зависимая сборка, но файл не является допустимой сборкой для текущей загруженной среды выполнения.

Комментарии

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

Примечание

Если тип был переадресован в другую сборку, он по-прежнему возвращается этим методом. Сведения о переадресации типов см. в разделе Переадресация типов в СРЕДЕ CLR.

Параметр throwOnError влияет только на то, что происходит, если тип не найден. Это не влияет на другие исключения, которые могут быть выданы. В частности, если тип найден, но не может быть загружен, TypeLoadException может вызываться, даже если throwOnError имеет значение false.

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

GetType(String, Boolean)

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

Возвращает объект Type с заданным именем в экземпляре сборки и может вызывать исключение, если тип не найден.

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError);
public virtual Type? GetType (string name, bool throwOnError);
public virtual Type GetType (string name, bool throwOnError);
override this.GetType : string * bool -> Type
Public Overridable Function GetType (name As String, throwOnError As Boolean) As Type

Параметры

name
String

Полное имя типа.

throwOnError
Boolean

Значение true для создания исключения, если тип не найден, в обратном случае — значение false, в результате чего будет возвращено значение null.

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

Объект, представляющий указанный класс.

Реализации

Исключения

name недопустим.

-или-

Длина name превышает 1024 символа.

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

throwOnError является true, не удается найти тип.

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

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

-или-

Текущая сборка была загружена в контекст только для отражения, а для name требуется зависимая сборка, которая не была предварительно загружена.

typeName Требуется зависимая сборка, но файл не является допустимой сборкой для текущей загруженной среды выполнения.

Комментарии

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

Примечание

Если тип был переадресован в другую сборку, он по-прежнему возвращается этим методом. Сведения о переадресации типов см. в разделе Переадресация типов в СРЕДЕ CLR.

Параметр throwOnError влияет только на то, что происходит, если тип не найден. Это не влияет на другие исключения, которые могут быть выданы. В частности, если тип найден, но не может быть загружен, TypeLoadException может вызываться, даже если throwOnError имеет значение false.

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

GetType(String)

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

Возвращает объект Type с указанным именем в экземпляре сборки.

public:
 virtual Type ^ GetType(System::String ^ name);
public virtual Type GetType (string name);
public virtual Type? GetType (string name);
override this.GetType : string -> Type
Public Overridable Function GetType (name As String) As Type

Параметры

name
String

Полное имя типа.

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

Объект, представляющий указанный класс, или null, если класс не найден.

Реализации

Исключения

name недопустим.

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

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

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

-или-

Текущая сборка была загружена в контекст только для отражения, а для name требуется зависимая сборка, которая не была предварительно загружена.

Примечание. В .NET для приложений Магазина Windows или переносимой библиотеки классов перехватите исключение базового класса , IOException.

typeName Требуется зависимая сборка, но файл не является допустимой сборкой для текущей загруженной среды выполнения.

Примеры

В следующем примере определяется абстрактный MeansOfTransportation класс в Transportation пространстве имен . Он вызывает GetType(String) метод для получения объекта Type , вызывает Type.GetProperties метод для получения массива PropertyInfo объектов, представляющих свойства типа, а затем отображает сведения об абстрактных свойствах типа. Обратите внимание, что при вызове GetType(String) метода используется полное имя типа (то есть его пространство имен вместе с именем типа).

using System;
using System.Reflection;

public class Example
{
    public static void Main()
    {
        Assembly assem = typeof(Example).Assembly;
        Type t = assem.GetType("Transportation.MeansOfTransportation");
        if (t != null)
        {
            Console.WriteLine($"Virtual properties in type {t.FullName}:");
            PropertyInfo[] props = t.GetProperties();
            int nVirtual = 0;
            for (int ctr = 0; ctr < props.Length; ctr++)
            {
                if (props[ctr].GetMethod.IsVirtual)
                {
                    Console.WriteLine($"   {props[ctr].Name} (type {props[ctr].PropertyType.FullName})");
                    nVirtual++;
                }
            }

            if (nVirtual == 0)
                Console.WriteLine("   No virtual properties");
        }
    }
}

namespace Transportation
{
    public abstract class MeansOfTransportation
    {
        abstract public bool HasWheels { get; set; }
        abstract public int Wheels { get; set; }
        abstract public bool ConsumesFuel { get; set; }
        abstract public bool Living { get; set; }
    }
}
// The example displays the following output:
//    Virtual properties in type Transportation.MeansOfTransportation:
//       HasWheels (type System.Boolean)
//       Wheels (type System.Int32)
//       ConsumesFuel (type System.Boolean)
//       Living (type System.Boolean)
Imports System.Reflection

Module Example
   Public Sub Main()
      Dim assem As Assembly = GetType(Example).Assembly
      Dim t As Type = assem.GetType("Transportation.MeansOfTransportation")
      If Not t Is Nothing Then
         Console.WriteLine("Virtual properties in type {0}:", 
                           t.FullName)
         Dim props() As PropertyInfo = t.GetProperties()
         Dim nVirtual As Integer = 0
         For ctr As Integer = 0 To props.Length - 1
            If props(ctr).GetMethod.IsVirtual Then
               Console.WriteLine("   {0} (type {1})",
                                 props(ctr).Name, 
                                 props(ctr).PropertyType.FullName)
               nVirtual += 1
            End If
         Next
         If nVirtual = 0 Then 
            Console.WriteLine("   No virtual properties")
         End If   
      End If   
   End Sub
End Module

Namespace Transportation
   Public MustInherit Class MeansOfTransportation
      Public MustOverride Property HasWheels As Boolean
      Public MustOverride Property Wheels As Integer
      Public MustOverride Property ConsumesFuel As Boolean
      Public MustOverride Property Living As Boolean
   End Class
End Namespace
' The example displays the following output:
'    Virtual properties in type Transportation.MeansOfTransportation:
'       HasWheels (type System.Boolean)
'       Wheels (type System.Int32)
'       ConsumesFuel (type System.Boolean)
'       Living (type System.Boolean)

Комментарии

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

Примечание

Если тип был переадресован в другую сборку, он по-прежнему возвращается этим методом. Сведения о переадресации типов см. в разделе Переадресация типов в СРЕДЕ CLR.

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

GetType()

public:
 virtual Type ^ GetType();
public Type GetType ();
override this.GetType : unit -> Type
Public Function GetType () As Type

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

Реализации

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