Assembly.GetType Метод

Ссылка

Определение

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

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

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

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

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

Получает объект 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.

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

Type

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

Реализации

GetType(String, Boolean, Boolean)

Исключения

ArgumentException

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

-или-

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

ArgumentNullException

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

TypeLoadException

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

FileNotFoundException

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

FileLoadException

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

-или-

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

BadImageFormatException

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

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

Type

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

Реализации

GetType(String, Boolean)

Исключения

ArgumentException

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

-или-

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

ArgumentNullException

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

TypeLoadException

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

FileNotFoundException

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

FileLoadException

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

-или-

BadImageFormatException

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

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

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

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

Type

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

Реализации

GetType(String)

Исключения

ArgumentException

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

ArgumentNullException

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

FileNotFoundException

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

FileLoadException

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

-или-

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

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)

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

GetType()

public:
 virtual Type ^ GetType();

public Type GetType ();

override this.GetType : unit -> Type

Public Function GetType () As Type

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

Type

Реализации

GetType()

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

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

Assembly.GetType Метод

Определение

Перегрузки

GetType(String, Boolean, Boolean)

Параметры

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

Реализации

Исключения

Комментарии

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

GetType(String, Boolean)

Параметры

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

Реализации

Исключения

Комментарии

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

GetType(String)

Параметры

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

Реализации

Исключения

Примеры

Комментарии

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

GetType()

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

Реализации

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

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