Assembly.GetType Assembly.GetType Assembly.GetType Assembly.GetType Method

Definição

Obtém o objeto Type que representa o tipo especificado.Gets the Type object that represents the specified type.

Sobrecargas

GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) 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.Gets the Type object with the specified name in the assembly instance, with the options of ignoring the case, and of throwing an exception if the type is not found.

GetType(String, Boolean) GetType(String, Boolean) GetType(String, Boolean) 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.Gets the Type object with the specified name in the assembly instance and optionally throws an exception if the type is not found.

GetType(String) GetType(String) GetType(String) GetType(String)

Obtém o objeto Type com o nome especificado na instância do assembly.Gets the Type object with the specified name in the assembly instance.

GetType() GetType() GetType() GetType()

GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) 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.Gets the Type object with the specified name in the assembly instance, with the options of ignoring the case, and of throwing an exception if the type is not found.

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

Parâmetros

name
String String String String

O nome completo do tipo.The full name of the type.

throwOnError
Boolean Boolean Boolean Boolean

true para gerar uma exceção se não for possível encontrar o tipo; false para retornar null.true to throw an exception if the type is not found; false to return null.

ignoreCase
Boolean Boolean Boolean Boolean

true para ignorar maiúsculas e minúsculas do nome do tipo; caso contrário, false.true to ignore the case of the type name; otherwise, false.

Retornos

Um objeto que representa a classe especificada.An object that represents the specified class.

Implementações

Exceções

name é inválido.name is invalid.

- ou --or- O comprimento de name excede 1024 caracteres.The length of name exceeds 1024 characters.

throwOnError é true e o tipo não pode ser encontrado.throwOnError is true, and the type cannot be found.

name exige um assembly dependente que não pôde ser encontrado.name requires a dependent assembly that could not be found.

name exige um assembly dependente que foi encontrado, mas que não pôde ser carregado.name requires a dependent assembly that was found but could not be loaded.

- ou --or- O assembly atual foi carregado no contexto somente reflexão e o name exige um assembly dependente que não foi pré-carregado.The current assembly was loaded into the reflection-only context, and name requires a dependent assembly that was not preloaded.

name exige um assembly dependente, mas o arquivo não é um assembly válido.name requires a dependent assembly, but the file is not a valid assembly.

- ou --or- name exige um assembly dependente que foi compilado para uma versão do tempo de execução posterior à versão carregada no momento.name requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Comentários

Esse método pesquisa apenas a instância do assembly atual.This method only searches the current assembly instance. O name parâmetro inclui o namespace, mas não o assembly.The name parameter includes the namespace but not the assembly. Para pesquisar outros assemblies para um tipo, use a Type.GetType(String) sobrecarga do método, que pode, opcionalmente, incluir um nome de exibição do assembly como parte do nome do tipo.To search other assemblies for a type, use the Type.GetType(String) method overload, which can optionally include an assembly display name as part of the type name.

Observação

Se o tipo foi encaminhado para outro assembly, ele ainda é retornado por esse método.If the type has been forwarded to another assembly, it is still returned by this method. Para obter informações sobre o encaminhamento de tipo, consulte o encaminhamento de tipo no Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

O throwOnError parâmetro afeta apenas o que acontece quando o tipo não é encontrado.The throwOnError parameter only affects what happens when the type is not found. Ele não afeta nenhuma outra exceção que possa ser lançada.It does not affect any other exceptions that might be thrown. Em particular, se o tipo for encontrado, mas não puder ser TypeLoadException carregado, poderá ser lançado throwOnError mesmo falsese for.In particular, if the type is found but cannot be loaded, TypeLoadException can be thrown even if throwOnError is false.

GetType(String, Boolean) GetType(String, Boolean) GetType(String, Boolean) 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.Gets the Type object with the specified name in the assembly instance and optionally throws an exception if the type is not found.

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 String String String

O nome completo do tipo.The full name of the type.

throwOnError
Boolean Boolean Boolean Boolean

true para gerar uma exceção se não for possível encontrar o tipo; false para retornar null.true to throw an exception if the type is not found; false to return null.

Retornos

Um objeto que representa a classe especificada.An object that represents the specified class.

Implementações

Exceções

name é inválido.name is invalid.

- ou --or- O comprimento de name excede 1024 caracteres.The length of name exceeds 1024 characters.

throwOnError é true e o tipo não pode ser encontrado.throwOnError is true, and the type cannot be found.

name exige um assembly dependente que não pôde ser encontrado.name requires a dependent assembly that could not be found.

name exige um assembly dependente que foi encontrado, mas que não pôde ser carregado.name requires a dependent assembly that was found but could not be loaded.

- ou --or- O assembly atual foi carregado no contexto somente reflexão e o name exige um assembly dependente que não foi pré-carregado.The current assembly was loaded into the reflection-only context, and name requires a dependent assembly that was not preloaded.

name exige um assembly dependente, mas o arquivo não é um assembly válido.name requires a dependent assembly, but the file is not a valid assembly.

- ou --or- name exige um assembly dependente que foi compilado para uma versão do tempo de execução posterior à versão carregada no momento.name requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Comentários

Esse método pesquisa apenas a instância do assembly atual.This method only searches the current assembly instance. O name parâmetro inclui o namespace, mas não o assembly.The name parameter includes the namespace but not the assembly. Para pesquisar outros assemblies para um tipo, use a Type.GetType(String) sobrecarga do método, que pode, opcionalmente, incluir um nome de exibição do assembly como parte do nome do tipo.To search other assemblies for a type, use the Type.GetType(String) method overload, which can optionally include an assembly display name as part of the type name.

Observação

Se o tipo foi encaminhado para outro assembly, ele ainda é retornado por esse método.If the type has been forwarded to another assembly, it is still returned by this method. Para obter informações sobre o encaminhamento de tipo, consulte o encaminhamento de tipo no Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

O throwOnError parâmetro afeta apenas o que acontece quando o tipo não é encontrado.The throwOnError parameter only affects what happens when the type is not found. Ele não afeta nenhuma outra exceção que possa ser lançada.It does not affect any other exceptions that might be thrown. Em particular, se o tipo for encontrado, mas não puder ser TypeLoadException carregado, poderá ser lançado throwOnError mesmo falsese for.In particular, if the type is found but cannot be loaded, TypeLoadException can be thrown even if throwOnError is false.

GetType(String) GetType(String) GetType(String) GetType(String)

Obtém o objeto Type com o nome especificado na instância do assembly.Gets the Type object with the specified name in the assembly instance.

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 String String String

O nome completo do tipo.The full name of the type.

Retornos

Um objeto que representa a classe especificada ou null se a classe não for encontrada.An object that represents the specified class, or null if the class is not found.

Implementações

Exceções

name exige um assembly dependente que não pôde ser encontrado.name requires a dependent assembly that could not be found.


Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, IOException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

name exige um assembly dependente que foi encontrado, mas que não pôde ser carregado. name requires a dependent assembly that was found but could not be loaded.

- ou --or- O assembly atual foi carregado no contexto somente reflexão e o name exige um assembly dependente que não foi pré-carregado.The current assembly was loaded into the reflection-only context, and name requires a dependent assembly that was not preloaded.

name exige um assembly dependente, mas o arquivo não é um assembly válido.name requires a dependent assembly, but the file is not a valid assembly.

- ou --or- name exige um assembly dependente que foi compilado para uma versão do tempo de execução posterior à versão carregada no momento.name requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Exemplos

O exemplo a seguir define uma MeansOfTransportation classe abstrata Transportation no namespace.The following example defines an abstract MeansOfTransportation class in the 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, em seguida, exibe informações sobre as propriedades abstratas do tipo.It calls the GetType(String) method to retrieve its Type object, calls the Type.GetProperties method to get an array of PropertyInfo objects that represent the type's properties, and then displays information on the type's abstract properties. 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).Note that the call to the GetType(String) method uses the type's fully qualified name (that is, its namespace along with its type name).

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 do assembly atual.This method only searches the current assembly instance. O name parâmetro inclui o namespace, mas não o assembly.The name parameter includes the namespace but not the assembly. Para pesquisar outros assemblies para um tipo, use a Type.GetType(String) sobrecarga do método, que pode, opcionalmente, incluir um nome de exibição do assembly como parte do nome do tipo.To search other assemblies for a type, use the Type.GetType(String) method overload, which can optionally include an assembly display name as part of the type name.

Observação

Se o tipo foi encaminhado para outro assembly, ele ainda é retornado por esse método.If the type has been forwarded to another assembly, it is still returned by this method. Para obter informações sobre o encaminhamento de tipo, consulte o encaminhamento de tipo no Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

GetType() GetType() GetType() GetType()

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

Retornos

Implementações

Aplica-se a