Module.GetType Método

Definición

Devuelve el tipo especificado.Returns the specified type.

Sobrecargas

GetType(String)

Devuelve el tipo especificado, mediante una búsqueda en la que se distingue entre mayúsculas y minúsculas.Returns the specified type, performing a case-sensitive search.

GetType(String, Boolean)

Devuelve el tipo especificado, buscando el módulo con la distinción de mayúsculas y minúsculas especificada.Returns the specified type, searching the module with the specified case sensitivity.

GetType(String, Boolean, Boolean)

Devuelve el tipo especificado, indicando si se realiza una búsqueda que distinga entre mayúsculas y minúsculas del módulo y si se produce una excepción si no se puede encontrar el 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)

Devuelve el tipo especificado, mediante una búsqueda en la que se distingue entre mayúsculas y 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

Nombre del tipo que se buscará.The name of the type to locate. Nombre debe estar completo con el espacio de nombres.The name must be fully qualified with the namespace.

Devoluciones

Objeto Type que representa el tipo especificado, si el tipo está en este módulo; de lo contrario, null.A Type object representing the given type, if the type is in this module; otherwise, null.

Atributos

Excepciones

className es null.className is null.

Se invoca a los inicializadores de clase y se produce una excepción.The class initializers are invoked and an exception is thrown.

className es cadena de longitud cero.className is a zero-length string.

className requiere un ensamblado dependiente que no se pudo encontrar.className requires a dependent assembly that could not be found.

className requiere un ensamblado dependiente que se encontró, pero no se pudo cargar.className requires a dependent assembly that was found but could not be loaded.

O bien,-or- El ensamblado actual se cargó en el contexto de solo reflexión y className requiere un ensamblado dependiente que no se haya cargado previamente.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

className requiere un ensamblado dependiente, pero el archivo no es un ensamblado válido.className requires a dependent assembly, but the file is not a valid assembly.

O bien,-or- className requiere un ensamblado dependiente compilado para una versión del tiempo de ejecución posterior a la versión cargada actualmente.className requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Ejemplos

En el ejemplo siguiente se muestra el nombre de un tipo en el 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

Comentarios

Nota

Si el tipo se ha reenviado a otro ensamblado, este método lo devuelve.If the type has been forwarded to another assembly, it is still returned by this method. Para obtener información sobre el reenvío de tipos, vea reenvío de tipos en Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

Un tipo se puede recuperar de un módulo concreto mediante Module.GetType.A type can be retrieved from a specific module using Module.GetType. La llamada a Module.GetType en el módulo que contiene el manifiesto no buscará en todo el ensamblado.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Para recuperar un tipo de un ensamblado, independientemente del módulo en el que se encuentra, debe llamar a Assembly.GetType.To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

GetType(String, Boolean)

Devuelve el tipo especificado, buscando el módulo con la distinción de mayúsculas y 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

Nombre del tipo que se buscará.The name of the type to locate. Nombre debe estar completo con el espacio de nombres.The name must be fully qualified with the namespace.

ignoreCase
Boolean

true para la búsqueda sin distinción entre mayúsculas y minúsculas; de lo contrario, false.true for case-insensitive search; otherwise, false.

Devoluciones

Objeto Type que representa el tipo especificado, si el tipo está en este módulo; de lo contrario, null.A Type object representing the given type, if the type is in this module; otherwise, null.

Atributos

Excepciones

className es null.className is null.

Se invoca a los inicializadores de clase y se produce una excepción.The class initializers are invoked and an exception is thrown.

className es cadena de longitud cero.className is a zero-length string.

className requiere un ensamblado dependiente que no se pudo encontrar.className requires a dependent assembly that could not be found.

className requiere un ensamblado dependiente que se encontró, pero no se pudo cargar.className requires a dependent assembly that was found but could not be loaded.

O bien,-or- El ensamblado actual se cargó en el contexto de solo reflexión y className requiere un ensamblado dependiente que no se haya cargado previamente.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

className requiere un ensamblado dependiente, pero el archivo no es un ensamblado válido.className requires a dependent assembly, but the file is not a valid assembly.

O bien,-or- className requiere un ensamblado dependiente compilado para una versión del tiempo de ejecución posterior a la versión cargada actualmente.className requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Ejemplos

En el ejemplo siguiente se muestra el nombre de un tipo en el módulo especificado, especificando false para el parámetro ignoreCase de modo que no se omitan las mayúsculas y minúsculas.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

Comentarios

Nota

Si el tipo se ha reenviado a otro ensamblado, este método lo devuelve.If the type has been forwarded to another assembly, it is still returned by this method. Para obtener información sobre el reenvío de tipos, vea reenvío de tipos en Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

Un tipo se puede recuperar de un módulo concreto mediante Module.GetType.A type can be retrieved from a specific module using Module.GetType. La llamada a Module.GetType en el módulo que contiene el manifiesto no buscará en todo el ensamblado.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Para recuperar un tipo de un ensamblado, independientemente del módulo en el que se encuentra, debe llamar a 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)

Devuelve el tipo especificado, indicando si se realiza una búsqueda que distinga entre mayúsculas y minúsculas del módulo y si se produce una excepción si no se puede encontrar el 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

Nombre del tipo que se buscará.The name of the type to locate. Nombre debe estar completo con el espacio de nombres.The name must be fully qualified with the namespace.

throwOnError
Boolean

Es true para producir una excepción si no se puede encontrar el tipo; es false para devolver null.true to throw an exception if the type cannot be found; false to return null.

ignoreCase
Boolean

true para la búsqueda sin distinción entre mayúsculas y minúsculas; de lo contrario, false.true for case-insensitive search; otherwise, false.

Devoluciones

Objeto Type que representa el tipo especificado, si el tipo se declara en este módulo; en caso contrario, es null.A Type object representing the specified type, if the type is declared in this module; otherwise, null.

Atributos

Excepciones

className es null.className is null.

Se invoca a los inicializadores de clase y se produce una excepción.The class initializers are invoked and an exception is thrown.

className es cadena de longitud cero.className is a zero-length string.

throwOnError es true y no se puede encontrar el tipo.throwOnError is true, and the type cannot be found.

className requiere un ensamblado dependiente que no se pudo encontrar.className requires a dependent assembly that could not be found.

className requiere un ensamblado dependiente que se encontró, pero no se pudo cargar.className requires a dependent assembly that was found but could not be loaded.

O bien,-or- El ensamblado actual se cargó en el contexto de solo reflexión y className requiere un ensamblado dependiente que no se haya cargado previamente.The current assembly was loaded into the reflection-only context, and className requires a dependent assembly that was not preloaded.

className requiere un ensamblado dependiente, pero el archivo no es un ensamblado válido.className requires a dependent assembly, but the file is not a valid assembly.

O bien,-or- className requiere un ensamblado dependiente compilado para una versión del tiempo de ejecución posterior a la versión cargada actualmente.className requires a dependent assembly which was compiled for a version of the runtime later than the currently loaded version.

Ejemplos

En el ejemplo siguiente se muestra el nombre de un tipo en el módulo especificado.The following example displays the name of a type in the specified module. Los parámetros throwOnError y ignoreCase se especifican 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

Comentarios

El parámetro throwOnError afecta solo a lo que ocurre cuando no se encuentra el tipo.The throwOnError parameter affects only what happens when the type is not found. No afecta a ninguna otra excepción que se pueda producir.It does not affect any other exceptions that might be thrown. En concreto, si se encuentra el tipo pero no se puede cargar, TypeLoadException se puede iniciar aunque se false``throwOnError.In particular, if the type is found but cannot be loaded, TypeLoadException can be thrown even if throwOnError is false.

Nota

Si el tipo se ha reenviado a otro ensamblado, este método lo devuelve.If the type has been forwarded to another assembly, it is still returned by this method. Para obtener información sobre el reenvío de tipos, vea reenvío de tipos en Common Language Runtime.For information on type forwarding, see Type Forwarding in the Common Language Runtime.

Un tipo se puede recuperar de un módulo concreto mediante Module.GetType.A type can be retrieved from a specific module using Module.GetType. La llamada a Module.GetType en el módulo que contiene el manifiesto no buscará en todo el ensamblado.Calling Module.GetType on the module that contains the manifest will not search the entire assembly. Para recuperar un tipo de un ensamblado, independientemente del módulo en el que se encuentra, debe llamar a Assembly.GetType.To retrieve a type from an assembly, regardless of which module it is in, you must call Assembly.GetType.

Se aplica a