Module.GetType Método

Definição

Retorna o tipo especificado.Returns the specified type.

Sobrecargas

GetType(String)

Retorna o tipo especificado, executando uma pesquisa que diferencia maiúsculas de minúsculas.Returns the specified type, performing a case-sensitive search.

GetType(String, Boolean)

Retorna o tipo especificado, pesquisando o módulo com a diferenciação de maiúsculas e minúsculas especificada.Returns the specified type, searching the module with the specified case sensitivity.

GetType(String, Boolean, Boolean)

Retorna o tipo especificado, especificando se deve ser feita uma pesquisa que diferencia maiúsculas de minúsculas do módulo e gerar uma exceção se não for possível localizar o tipo.Returns the specified type, specifying whether to make a case-sensitive search of the module and whether to throw an exception if the type cannot be found.

GetType(String)

Retorna o tipo especificado, executando uma pesquisa que diferencia maiúsculas de minúsculas.Returns the specified type, performing a case-sensitive search.

public:
 virtual Type ^ GetType(System::String ^ className);
[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType (string className);
override this.GetType : string -> Type
Public Overridable Function GetType (className As String) As Type

Parâmetros

className
String

O nome do tipo a ser localizado.The name of the type to locate. O nome deve ser totalmente qualificado com o namespace.The name must be fully qualified with the namespace.

Retornos

Um objeto Type que representará o tipo especificado se o tipo estiver nesse módulo; caso contrário, null.A Type object representing the given type, if the type is in this module; otherwise, null.

Atributos

Exceções

className é null.className is null.

Os inicializadores de classe são invocados e uma exceção é gerada.The class initializers are invoked and an exception is thrown.

className é uma cadeia de comprimento zero.className is a zero-length string.

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

className exige um assembly dependente que foi encontrado, mas que não pôde ser carregado.className 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 className exige um assembly dependente que não foi pré-carregado.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

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

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

Exemplos

O exemplo a seguir exibe o nome de um tipo no módulo especificado.The following example displays the name of a type in the specified module.

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->Assembly->GetModules( false );
   
   //In a simple project with only one module, the module at index
   // 0 will be the module containing these classes.
   Module^ myModule = moduleArray[ 0 ];
   Type^ myType;
   myType = myModule->GetType( "ReflectionModule_Examples.MyMainClass" );
   Console::WriteLine( "Got type: {0}", myType );
}

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing these classes.
            Module myModule = moduleArray[0];

            Type myType;

            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass");
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}
Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing these classes.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type

            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass")
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Comentários

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.

Um tipo pode ser recuperado de um módulo específico usando Module.GetType.A type can be retrieved from a specific module using Module.GetType. Chamar Module.GetType no módulo que contém o manifesto não pesquisará o assembly inteiro.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Para recuperar um tipo de um assembly, independentemente de qual módulo ele está, você deve chamar Assembly.GetType.To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

GetType(String, Boolean)

Retorna o tipo especificado, pesquisando o módulo com a diferenciação de maiúsculas e minúsculas especificada.Returns the specified type, searching the module with the specified case sensitivity.

public:
 virtual Type ^ GetType(System::String ^ className, bool ignoreCase);
[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType (string className, bool ignoreCase);
override this.GetType : string * bool -> Type
Public Overridable Function GetType (className As String, ignoreCase As Boolean) As Type

Parâmetros

className
String

O nome do tipo a ser localizado.The name of the type to locate. O nome deve ser totalmente qualificado com o namespace.The name must be fully qualified with the namespace.

ignoreCase
Boolean

true para a pesquisa que não diferencia maiúsculas de minúsculas; caso contrário, false.true for case-insensitive search; otherwise, false.

Retornos

Um objeto Type que representará o tipo especificado se o tipo estiver nesse módulo; caso contrário, null.A Type object representing the given type, if the type is in this module; otherwise, null.

Atributos

Exceções

className é null.className is null.

Os inicializadores de classe são invocados e uma exceção é gerada.The class initializers are invoked and an exception is thrown.

className é uma cadeia de comprimento zero.className is a zero-length string.

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

className exige um assembly dependente que foi encontrado, mas que não pôde ser carregado.className 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 className exige um assembly dependente que não foi pré-carregado.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

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

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

Exemplos

O exemplo a seguir exibe o nome de um tipo no módulo especificado, especificando false para o parâmetro ignoreCase para que o caso não seja ignorado.The following example displays the name of a type in the specified module, specifying false for the ignoreCase parameter so that case will not be ignored.

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->Assembly->GetModules( false );
   
   //In a simple project with only one module, the module at index
   // 0 will be the module containing these classes.
   Module^ myModule = moduleArray[ 0 ];
   Type^ myType;
   myType = myModule->GetType( "ReflectionModule_Examples.MyMainClass", false );
   Console::WriteLine( "Got type: {0}", myType );
}

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing these classes.
            Module myModule = moduleArray[0];

            Type myType;
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", false);
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}
Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing these classes.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", False)
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Comentários

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.

Um tipo pode ser recuperado de um módulo específico usando Module.GetType.A type can be retrieved from a specific module using Module.GetType. Chamar Module.GetType no módulo que contém o manifesto não pesquisará o assembly inteiro.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Para recuperar um tipo de um assembly, independentemente de qual módulo ele está, você deve chamar Assembly.GetType.To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

GetType(String, Boolean, Boolean)

Retorna o tipo especificado, especificando se deve ser feita uma pesquisa que diferencia maiúsculas de minúsculas do módulo e gerar uma exceção se não for possível localizar o tipo.Returns the specified type, specifying whether to make a case-sensitive search of the module and whether to throw an exception if the type cannot be found.

public:
 virtual Type ^ GetType(System::String ^ className, bool throwOnError, bool ignoreCase);
[System.Runtime.InteropServices.ComVisible(true)]
public virtual Type GetType (string className, bool throwOnError, bool ignoreCase);
override this.GetType : string * bool * bool -> Type
Public Overridable Function GetType (className As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Parâmetros

className
String

O nome do tipo a ser localizado.The name of the type to locate. O nome deve ser totalmente qualificado com o namespace.The name must be fully qualified with the namespace.

throwOnError
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 cannot be found; false to return null.

ignoreCase
Boolean

true para a pesquisa que não diferencia maiúsculas de minúsculas; caso contrário, false.true for case-insensitive search; otherwise, false.

Retornos

Um objeto Type que representa o tipo especificado, se o tipo for declarado neste módulo; caso contrário, null.A Type object representing the specified type, if the type is declared in this module; otherwise, null.

Atributos

Exceções

className é null.className is null.

Os inicializadores de classe são invocados e uma exceção é gerada.The class initializers are invoked and an exception is thrown.

className é uma cadeia de comprimento zero.className is a zero-length string.

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

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

className exige um assembly dependente que foi encontrado, mas que não pôde ser carregado.className 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 className exige um assembly dependente que não foi pré-carregado.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

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

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

Exemplos

O exemplo a seguir exibe o nome de um tipo no módulo especificado.The following example displays the name of a type in the specified module. Os parâmetros throwOnError e ignoreCase são especificados como false.The throwOnError and ignoreCase parameters are specified as false.

using namespace System;
using namespace System::Reflection;

namespace ReflectionModule_Examples
{
   public ref class MyMainClass{};

}

int main()
{
   array<Module^>^moduleArray;
   moduleArray = ReflectionModule_Examples::MyMainClass::typeid->Assembly->GetModules( false );
   
   //In a simple project with only one module, the module at index
   // 0 will be the module containing this class.
   Module^ myModule = moduleArray[ 0 ];
   Type^ myType;
   myType = myModule->GetType( "ReflectionModule_Examples.MyMainClass", false, false );
   Console::WriteLine( "Got type: {0}", myType );
}

using System;
using System.Reflection;

namespace ReflectionModule_Examples
{
    class MyMainClass
    {
        static void Main()
        {
            Module[] moduleArray;
            
            moduleArray = typeof(MyMainClass).Assembly.GetModules(false);
            
            //In a simple project with only one module, the module at index
            // 0 will be the module containing this class.
            Module myModule = moduleArray[0];

            Type myType;
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", false, false);
            Console.WriteLine("Got type: {0}", myType.ToString());
        }
    }
}
Imports System.Reflection

'This code assumes that the root namespace is set to empty("").
Namespace ReflectionModule_Examples
    Class MyMainClass
        Shared Sub Main()
            Dim moduleArray() As [Module]

            moduleArray = GetType(MyMainClass).Assembly.GetModules(False)

            'In a simple project with only one module, the module at index
            ' 0 will be the module containing this class.
            Dim myModule As [Module] = moduleArray(0)

            Dim myType As Type
            myType = myModule.GetType("ReflectionModule_Examples.MyMainClass", False, False)
            Console.WriteLine("Got type: {0}", myType.ToString())
        End Sub
    End Class
End Namespace 'ReflectionModule_Examples

Comentários

O parâmetro throwOnError afeta apenas o que acontece quando o tipo não é encontrado.The throwOnError parameter affects only 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 carregado, TypeLoadException poderá ser lançado mesmo se throwOnError for false.In particular, if the type is found but cannot be loaded, TypeLoadException can be thrown even if throwOnError is false.

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.

Um tipo pode ser recuperado de um módulo específico usando Module.GetType.A type can be retrieved from a specific module using Module.GetType. Chamar Module.GetType no módulo que contém o manifesto não pesquisará o assembly inteiro.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Para recuperar um tipo de um assembly, independentemente de qual módulo ele está, você deve chamar Assembly.GetType.To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

Aplica-se a