Assembly.GetType Метод

Определение

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

Сборки:: mscorlib.dll, System.Reflection.dll

Сборка:: mscorlib.dll

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

Сборка:: netstandard.dll

Важно!

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

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

Перегрузки

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

GetType(String, Boolean, Boolean)

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

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

, чтобы создать исключение, если тип не найден; значение a

ignoreCase: Boolean

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

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

Type

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

Реализации

GetType(String, Boolean, Boolean)

Исключения

ArgumentException

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

–или–

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

ArgumentNullException

name равно null.

TypeLoadException

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

FileNotFoundException

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

FileLoadException

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

–или–

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

BadImageFormatException

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

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

В .NET Core/.NET 5+, если в строке имени типа имеются параметры универсального типа, эти ссылки на сборки будут загружены AssemblyLoadContext метода, который называется Assembly.GetType, или контекстом AssemblyLoadContext.CurrentContextualReflectionContext, если он задан.

Note

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

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

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

GetType(String, Boolean)

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

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

, чтобы создать исключение, если тип не найден; значение a

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

Type

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

Реализации

GetType(String, Boolean)

Исключения

ArgumentException

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

–или–

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

ArgumentNullException

name равно null.

TypeLoadException

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

FileNotFoundException

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

FileLoadException

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

–или–

BadImageFormatException

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

GetType()

public:
 virtual Type ^ GetType();

public Type GetType();

override this.GetType : unit -> Type

Public Function GetType () As Type

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

Type

Реализации

GetType()

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

GetType(String)

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

public:
 virtual Type ^ GetType(System::String ^ name);

public virtual Type GetType(string name);

override this.GetType : string -> Type

Public Overridable Function GetType (name As String) As Type

Параметры

name: String

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

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

Type

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

Реализации

GetType(String)

Исключения

ArgumentException

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

ArgumentNullException

name равно null.

FileNotFoundException

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

FileLoadException

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

–или–

BadImageFormatException

Примеры

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

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

Обратная связь

Были ли сведения на этой странице полезными?

Assembly.GetType Метод

Определение

Перегрузки

GetType(String, Boolean, Boolean)

Параметры

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

Реализации

Исключения

Комментарии

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

GetType(String, Boolean)

Параметры

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

Реализации

Исключения

Комментарии

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

GetType()

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

Реализации

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

GetType(String)

Параметры

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

Реализации

Исключения

Примеры

Комментарии

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