Assembly.GetType Método

Definição

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Obtém o objeto Type que representa o tipo especificado.

Sobrecargas

GetType(String, Boolean, Boolean)	Obtém o objeto Type com o nome especificado na instância do assembly, com a opção de ignorar a diferença entre maiúsculas e minúsculas e de gerar uma exceção se o tipo não for encontrado.
GetType(String, Boolean)	Obtém o objeto Type com o nome especificado na instância do assembly e, opcionalmente, lança uma exceção se o tipo não for encontrado.
GetType(String)	Obtém o objeto Type com o nome especificado na instância do assembly.

GetType(String, Boolean, Boolean)

Origem:

Assembly.cs

Obtém o objeto Type com o nome especificado na instância do assembly, com a opção de ignorar a diferença entre maiúsculas e minúsculas e de gerar uma exceção se o tipo não for encontrado.

public:
 virtual Type ^ GetType(System::String ^ name, bool throwOnError, bool ignoreCase);

public virtual 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

Parâmetros

name

String

O nome completo do tipo.

throwOnError

Boolean

true para gerar uma exceção se não for possível encontrar o tipo; false para retornar null.

ignoreCase

Boolean

true para ignorar maiúsculas e minúsculas do nome do tipo; caso contrário, false.

Retornos

Type

Um objeto que representa a classe especificada.

Exceções

ArgumentException

name é inválido.

- ou -

O comprimento de name excede 1024 caracteres.

ArgumentNullException

name é null.

TypeLoadException

throwOnError é true e o tipo não pode ser encontrado.

FileNotFoundException

name requer um assembly dependente que não pôde ser encontrado.

FileLoadException

name exige um assembly dependente que foi encontrado, mas que não pôde ser carregado.

- ou -

O assembly atual foi carregado no contexto somente reflexão e o name exige um assembly dependente que não foi pré-carregado.

BadImageFormatException

typeName requer um assembly dependente, mas o arquivo não é um assembly válido para o runtime carregado no momento.

Comentários

Esse método pesquisa apenas a instância de assembly atual. O name parâmetro inclui o namespace, mas não o assembly. Para pesquisar por um tipo em outros assemblies, use a sobrecarga de Type.GetType(String) método, que pode incluir opcionalmente um nome de exibição de assembly como parte do nome do tipo.

Observação

Se o tipo tiver sido encaminhado para outro assembly, ele ainda será retornado por esse método. Para obter informações sobre o encaminhamento de tipos, consulte Encaminhamento de tipos no Common Language Runtime.

O throwOnError parâmetro afeta apenas o que acontece quando o tipo não é encontrado. Ela não afeta nenhuma outra exceção que possa ser gerada. Em particular, se o tipo for encontrado, mas não puder ser carregado, TypeLoadException poderá ser gerado mesmo se throwOnError for false.

GetType(String, Boolean)

Origem:

Assembly.cs

Obtém o objeto Type com o nome especificado na instância do assembly e, opcionalmente, lança uma exceção se o tipo não for encontrado.

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

name

String

O nome completo do tipo.

throwOnError

Boolean

true para gerar uma exceção se não for possível encontrar o tipo; false para retornar null.

Retornos

Type

Um objeto que representa a classe especificada.

Exceções

ArgumentException

name é inválido.

- ou -

O comprimento de name excede 1024 caracteres.

ArgumentNullException

name é null.

TypeLoadException

throwOnError é true e o tipo não pode ser encontrado.

FileNotFoundException

name requer um assembly dependente que não pôde ser encontrado.

FileLoadException

name exige um assembly dependente que foi encontrado, mas que não pôde ser carregado.

- ou -

O assembly atual foi carregado no contexto somente reflexão e o name exige um assembly dependente que não foi pré-carregado.

BadImageFormatException

typeName requer um assembly dependente, mas o arquivo não é um assembly válido para o runtime carregado no momento.

Comentários

Esse método pesquisa apenas a instância de assembly atual. O name parâmetro inclui o namespace, mas não o assembly. Para pesquisar por um tipo em outros assemblies, use a sobrecarga de Type.GetType(String) método, que pode incluir opcionalmente um nome de exibição de assembly como parte do nome do tipo.

Observação

Se o tipo tiver sido encaminhado para outro assembly, ele ainda será retornado por esse método. Para obter informações sobre o encaminhamento de tipos, consulte Encaminhamento de tipos no Common Language Runtime.

O throwOnError parâmetro afeta apenas o que acontece quando o tipo não é encontrado. Ela não afeta nenhuma outra exceção que possa ser gerada. Em particular, se o tipo for encontrado, mas não puder ser carregado, TypeLoadException poderá ser gerado mesmo se throwOnError for false.

GetType(String)

Origem:

Assembly.cs

Obtém o objeto Type com o nome especificado na instância do assembly.

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

name

String

O nome completo do tipo.

Retornos

Type

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

Exceções

ArgumentException

name é inválido.

ArgumentNullException

name é null.

FileNotFoundException

name requer um assembly dependente que não pôde ser encontrado.

FileLoadException

name exige um assembly dependente que foi encontrado, mas que não pôde ser carregado.

- ou -

O assembly atual foi carregado no contexto somente reflexão e o name exige um assembly dependente que não foi pré-carregado.

Observação: no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, IOException, em vez disso.

BadImageFormatException

typeName requer um assembly dependente, mas o arquivo não é um assembly válido para o runtime carregado no momento.

Exemplos

O exemplo a seguir define uma classe abstrata MeansOfTransportation no Transportation namespace. Ele chama o GetType(String) método para recuperar seu Type objeto, chama o Type.GetProperties método para obter uma matriz de PropertyInfo objetos que representam as propriedades do tipo e exibe informações sobre as propriedades abstratas do tipo. Observe que a chamada para o GetType(String) método usa o nome totalmente qualificado do tipo (ou seja, seu namespace junto com seu nome de 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)

Comentários

Esse método pesquisa apenas a instância de assembly atual. O name parâmetro inclui o namespace, mas não o assembly. Para pesquisar por um tipo em outros assemblies, use a sobrecarga de Type.GetType(String) método, que pode incluir opcionalmente um nome de exibição de assembly como parte do nome do tipo.

Observação

Se o tipo tiver sido encaminhado para outro assembly, ele ainda será retornado por esse método. Para obter informações sobre o encaminhamento de tipos, consulte Encaminhamento de tipos no Common Language Runtime.