Assembly.GetType Método

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

Parâmetros

Devoluções

Um objeto que representa a classe especificada.

Implementações

Exceções

Observações

Este método pesquisa apenas a instância de montagem atual. O name parâmetro inclui o namespace, mas não a assembleia. Para pesquisar noutras assemblagens um tipo, use o Type.GetType(String) método overload, que pode opcionalmente incluir um nome de apresentação de montagem como parte do nome do tipo.

Em .NET Core/.NET 5+, se existirem parâmetros genéricos de tipo qualificados para montagem na cadeia de nomes do tipo, essas referências de montagem serão carregadas pelo AssemblyLoadContext do método que chamou Assembly.GetType, ou pelo contexto AssemblyLoadContext.CurrentContextualReflectionContext se estiver definido.

O throwOnError parâmetro só afeta o que acontece quando o tipo não é encontrado. Não afeta quaisquer outras exceções que possam ser incluídas. Em particular, se o tipo for encontrado mas não puder ser carregado, TypeLoadException pode ser lançado mesmo que throwOnError seja false.

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

Parâmetros

Devoluções

Um objeto que representa a classe especificada.

Implementações

Exceções

Observações

Este método pesquisa apenas a instância de montagem atual. O name parâmetro inclui o namespace, mas não a assembleia. Para pesquisar noutras assemblagens um tipo, use o Type.GetType(String) método overload, que pode opcionalmente incluir um nome de apresentação de montagem como parte do nome do tipo.

Em .NET Core/.NET 5+, se existirem parâmetros genéricos de tipo qualificados para montagem na cadeia de nomes do tipo, essas referências de montagem serão carregadas pelo AssemblyLoadContext do método que chamou Assembly.GetType, ou pelo contexto AssemblyLoadContext.CurrentContextualReflectionContext se estiver definido.

O throwOnError parâmetro só afeta o que acontece quando o tipo não é encontrado. Não afeta quaisquer outras exceções que possam ser incluídas. Em particular, se o tipo for encontrado mas não puder ser carregado, TypeLoadException pode ser lançado mesmo que throwOnError seja false.

public:
 virtual Type ^ GetType();

public Type GetType();

override this.GetType : unit -> Type

Public Function GetType () As Type

Devoluções

Implementações

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

Parâmetros

Devoluções

Um objeto que representa a classe especificada, ou null se a classe não for encontrada.

Implementações

Exceções

Exemplos

O exemplo seguinte define uma classe abstrata MeansOfTransportation no Transportation espaço de nomes. Chama o GetType(String) método para recuperar o seu Type objeto, chama o Type.GetProperties método para obter um array de PropertyInfo objetos que representam as propriedades do tipo, e depois apresenta informação sobre as propriedades abstratas do tipo. Note-se que a chamada ao GetType(String) método utiliza o nome totalmente qualificado do tipo (ou seja, o seu espaço de nomes juntamente com o nome do tipo).

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)

Observações

Este método pesquisa apenas a instância de montagem atual. O name parâmetro inclui o namespace, mas não a assembleia. Para pesquisar noutras assemblagens um tipo, use o Type.GetType(String) método overload, que pode opcionalmente incluir um nome de apresentação de montagem como parte do nome do tipo.

Em .NET Core/.NET 5+, se existirem parâmetros genéricos de tipo qualificados para montagem na cadeia de nomes do tipo, essas referências de montagem serão carregadas pelo AssemblyLoadContext do método que chamou Assembly.GetType, ou pelo contexto AssemblyLoadContext.CurrentContextualReflectionContext se estiver definido.