Type (Clase)

Type es la raíz de la funcionalidad de System.Reflection y constituye el modo principal de obtener acceso a los metadatos. Hay que utilizar los miembros de Type para obtener información acerca de una declaración de tipos, como los constructores, métodos, campos, propiedades y eventos de una clase, así como el módulo y el ensamblado en los que se implementa la clase.

El operador typeof de C# (operador GetType en Visual Basic, operador typeid en Visual C++) devuelve un objeto Type.

Un objeto Type que representa un tipo es único; es decir, dos referencias al objeto Type hacen referencia al mismo objeto sólo si representan el mismo tipo. Esto permite comparar los objetos Type mediante la igualdad de referencia.

No se requiere ningún permiso para que el código use la reflexión para obtener información sobre los tipos y sus miembros, sin tener en cuenta sus niveles de acceso. No se requiere ningún permiso para que el código use la reflexión para tener acceso a los miembros públicos u otros miembros en cuyos niveles de acceso los convertirían en visibles durante la compilación normal. Sin embargo, para que su código use la reflexión para tener acceso a los miembros que serían normalmente inaccesibles, como métodos privados o internos o campos protegidos de un tipo que su clase no hereda, su código debe tener ReflectionPermission. Vea Consideraciones de seguridad sobre la reflexión.

Type es una clase base abstracta que permite diversas implementaciones. El sistema siempre proporcionará el RuntimeType de la clase derivada. En la reflexión, todas las clases que comienzan por la palabra Runtime se crean sólo una vez por cada objeto del sistema y admiten operaciones de comparación.

Nota
En escenarios de multithreading, no bloquee objetos Type para sincronizar el acceso a datos static. Otro código, sobre el que no tiene control, también puede bloquear el tipo de clase. Esto puede originar un interbloqueo. En su lugar, sincronice el acceso a datos estáticos bloqueando un objeto static privado.

Esta clase es segura para la ejecución de subprocesos; varios subprocesos pueden leer simultáneamente de una instancia de este tipo. Una instancia de Type puede representar cualquiera de los siguientes tipos:

• Clases

• Tipos de valor

• Matrices

• Interfaces

• Punteros

• Enumeraciones

• Tipos genéricos construidos y definiciones de tipo genérico

• Argumentos y parámetros de tipos genéricos construidos, definiciones de tipo genérico y definiciones de método genérico

Se puede obtener una referencia al objeto Type asociado a un tipo de los modos siguientes:

• El método Object.GetType devuelve un objeto Type que representa el tipo de una instancia.

• Los métodos estáticos GetType devuelven un objeto Type que representa un tipo especificado mediante su nombre completo.

• Los métodos Module.GetTypes, Module.GetType y Module.FindTypes devuelven objetos Type que representan los tipos definidos en un módulo. El primer método se puede utilizar para obtener una matriz de objetos Type de todos los tipos públicos y privados definidos en un módulo. (Es posible obtener una instancia de Module a través del método Assembly.GetModule o Assembly.GetModules, o a través de la propiedad Type.Module.)

• El objeto System.Reflection.Assembly contiene varios métodos para recuperar las clases definidas en un ensamblado, incluidas [O:System.Reflection.Assembly.GetType], Assembly.GetTypes y Assembly.GetExportedTypes.

• El método FindInterfaces devuelve una lista filtrada con los tipos de interfaz admitidos por un tipo.

• El método GetElementType devuelve un objeto Type que representa el elemento.

• Los métodos GetInterfaces y GetInterface devuelven objetos Type que representan los tipos de interfaz que admite un tipo.

• El método GetTypeArray devuelve una matriz de objetos Type que representan los tipos especificados por un conjunto arbitrario de objetos. Los objetos se especifican con una matriz de tipo Object.

• Los métodos GetTypeFromProgID y GetTypeFromCLSID se proporcionan para que exista interoperabilidad con COM. Devuelven un objeto Type que representa el tipo especificado por el identificador ProgID o CLSID.

• El método GetTypeFromHandle se proporciona para que exista interoperabilidad. Devuelve un objeto Type que representa el tipo especificado por un identificador de clase.

• Los operadores typeof de C#, typeid de C++ y GetType de Visual Basic obtienen el objeto Type para un tipo.

• El método MakeGenericType devuelve un objeto Type que representa un tipo genérico construido, el cual es un tipo construido abierto si su propiedad ContainsGenericParameters devuelve true y un tipo construido cerrado en caso contrario. Sólo se pueden crear instancias de un tipo genérico si está cerrado.

• Los métodos MakeArrayType, MakePointerType y MakeByRefType devuelven objetos Type que representan, respectivamente, una matriz de un tipo especificado, un puntero a un tipo especificado y el tipo de un parámetro de referencia (ref en C#, ByRef en Visual Basic).

Nota
Una clase derivada puede obtener acceso a miembros protegidos de las clases base del código de llamada. Además, se permite el acceso a miembros del ensamblado de código de llamada. Como norma, si se ha permitido el acceso a un código enlazado en tiempo de compilación, también se permitirá el acceso a un código enlazado en tiempo de ejecución.

Nota
Las interfaces que amplían otras interfaces no heredan los métodos definidos en las interfaces extendidas.

Al heredar de Type, es preciso reemplazar los siguientes miembros: GUID, InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]), Module, Assembly, TypeHandle, FullName, Namespace, AssemblyQualifiedName, BaseType, GetConstructorImpl, GetConstructors(BindingFlags), GetMethodImpl, GetMethods(BindingFlags), GetField(String, BindingFlags), GetFields(BindingFlags), GetInterface(String, Boolean), GetInterfaces(), GetEvent(String, BindingFlags), GetEvents(BindingFlags), GetPropertyImpl, GetProperties(BindingFlags), GetNestedType(String, BindingFlags), GetNestedTypes(BindingFlags), GetAttributeFlagsImpl, IsArrayImpl, IsByRefImpl, IsPointerImpl, IsPrimitiveImpl, IsCOMObjectImpl, GetElementType(), HasElementTypeImpl, UnderlyingSystemType, MemberInfo.Name, MemberInfo.IsDefined, MemberInfo.GetCustomAttributes(Boolean) y GetCustomAttributes.

En el ejemplo de código siguiente se muestran algunas características representativas de Type. El operador typeof de C# (operador GetType en Visual Basic, operador typeid en Visual C++) se utiliza para obtener un objeto Type que representa String. Desde este Type objeto, el método GetMethod se utiliza para obtener MethodInfo que representa la sobrecarga de Substring que toma una ubicación inicial y una longitud.

Para identificar la firma de la sobrecarga, en el ejemplo de código se crea una matriz temporal que contiene dos objetos Type que representan int (Integer en Visual Basic).

Nota
Para ser precisos, la matriz contiene dos referencias a la instancia de Type que representa int en el dominio de aplicación actual. Para cualquier tipo, sólo hay una instancia de Type por dominio de aplicación.

En el ejemplo de código se utiliza MethodInfo para llamar al método Substring en la cadena "Hello, World!", y se muestra el resultado.

using System;
using System.Reflection;

class Example
{
    static void Main()
    {
        Type t = typeof(String);

        MethodInfo substr = t.GetMethod("Substring", 
            new Type[] { typeof(int), typeof(int) });

        Object result = 
            substr.Invoke("Hello, World!", new Object[] { 7, 5 });
        Console.WriteLine("{0} returned \"{1}\".", substr, result);
    }
}

/* This code example produces the following output:

System.String Substring(Int32, Int32) returned "World".
 */

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Este tipo es seguro para la ejecución de subprocesos.

Referencia

Otros recursos