Classe Type

Type è la radice della funzionalità dello spazio dei nomi System.Reflection e rappresenta il modo principale per accedere ai metadati. Utilizzare i membri di Type per ottenere informazioni su una dichiarazione del tipo, come i costruttori, i metodi, i campi, le proprietà e gli eventi di una classe, oltre al modulo e all'assembly in cui la classe è distribuita.

L'operatore typeof di C# (GetType in Visual Basic, typeid in Visual C++) restituisce un oggetto Type.

Un oggetto Type che rappresenta un tipo è univoco: due riferimenti a un oggetto Type fanno riferimento allo stesso oggetto solo se rappresentano lo stesso tipo. In questo modo, è possibile eseguire il confronto di oggetti Type utilizzando l'uguaglianza dei riferimenti.

Non è richiesta alcuna autorizzazione che consenta al codice di utilizzare la reflection per ottenere informazioni sui tipi e sui membri, indipendentemente dai relativi livelli di accesso. Non è richiesta alcuna autorizzazione che consenta al codice di utilizzare la reflection per accedere ai membri pubblici o ad altri membri i cui livelli di accesso li renderebbero visibili durante la normale compilazione. Tuttavia, affinché il codice utilizzi reflection per accedere ai membri che sarebbero generalmente inaccessibili, ad esempio i metodi privati o interni o i campi protetti di un tipo che la classe non eredita, il codice deve disporre di ReflectionPermission. Vedere Considerazioni sulla sicurezza in relazione alla reflection.

Type è una classe base astratta che consente più implementazioni. Verrà sempre fornito il RuntimeType della classe derivata. Nella reflection tutte le classi che iniziano con la parola Runtime sono create una sola volta per ogni oggetto nel sistema e supportano operazioni di confronto.

Nota
Negli scenari multithreading, non bloccare oggetti Type per sincronizzare l'accesso a dati static. Anche altro tipo di codice, su cui non si ha controllo, potrebbe comportare il blocco del tipo della classe. La conseguenza diretta potrebbe essere un deadlock. Sincronizzare invece l'accesso a dati statici bloccando un oggetto static privato.

Si tratta di una classe thread-safe. Più thread possono eseguire contemporaneamente la lettura di un'istanza di questo tipo. Un'istanza di Type può rappresentare uno qualsiasi dei seguenti tipi:

• Classi

• Tipi di valore

• Matrici

• Interfacce

• Puntatori

• Enumerazioni

• Tipi generici costruiti e definizioni di tipo generico

• Argomenti e parametri di tipo di tipi generici costruiti, definizioni di tipo generico e definizioni di metodo generico

È possibile ottenere un riferimento all'oggetto Type associato a un tipo nei modi descritti di seguito:

• Il metodo Object.GetType restituisce un oggetto Type che rappresenta il tipo di un'istanza.

• Il metodo GetType statico restituisce un oggetto Type che rappresenta un tipo specificato con il nome completo.

• I metodi Module.GetTypes, Module.GetType e Module.FindTypes restituiscono oggetti Type che rappresentano i tipi definiti in un modulo. Il primo metodo può essere utilizzato per ottenere una matrice di oggetti Type per tutti i tipi pubblici e privati definiti in un modulo. Per ottenere un'istanza di Module è possibile utilizzare il metodo Assembly.GetModule o Assembly.GetModules, oppure la proprietà Type.Module.

• L'oggetto System.Reflection.Assembly contiene un numero di metodi per recuperare le classi definite in un assembly, tra cui Assembly.GetType, Assembly.GetTypes e Assembly.GetExportedTypes.

• Il metodo FindInterfaces restituisce un elenco filtrato dei tipi di interfaccia supportati da un tipo.

• Il metodo GetElementType restituisce un oggetto Type che rappresenta l'elemento.

• I metodi GetInterfaces e GetInterface restituiscono oggetti Type che rappresentano i tipi di interfaccia supportati da un tipo.

• Il metodo GetTypeArray restituisce una matrice di oggetti Type che rappresentano i tipi specificati da un insieme arbitrario di oggetti. Gli oggetti sono specificati con una matrice di tipo Object.

• I metodi GetTypeFromProgID e GetTypeFromCLSID sono forniti per l'interoperabilità COM. Restituiscono un oggetto Type che rappresenta il tipo specificato da un ProgID o CLSID.

• Il metodo GetTypeFromHandle viene fornito per l'interoperabilità. Restituisce un oggetto Type che rappresenta il tipo specificato da un handle della classe.

• L'operatore typeof C#, l'operatore typeid C++ e l'operatore GetType Visual Basic ottengono l'oggetto Type per un tipo.

• Il metodo MakeGenericType restituisce un oggetto Type che rappresenta un tipo generico costruito, ovvero un tipo costruito aperto se la relativa proprietà ContainsGenericParameters restituisce true e un tipo costruito chiuso in caso contrario. È possibile creare un'istanza di un tipo generico soltanto se si tratta di un tipo generico chiuso.

• I metodi MakeArrayType, MakePointerType e MakeByRefType restituiscono oggetti Type che rappresentano rispettivamente una matrice di un tipo specificato, un puntatore a un tipo specificato e il tipo di un parametro di riferimento (ref in C#, ByRef in Visual Basic).

Nota
Una classe derivata può accedere ai membri protetti delle classi base del codice chiamante. Inoltre, l'accesso è consentito ai membri a livello di assembly dell'assembly del codice chiamante. In genere, se viene consentito l'accesso al codice ad associazione anticipata, viene consentito anche al codice ad associazione tardiva.

Nota
Le interfacce che estendono altre interfacce non ereditano i metodi definiti nelle interfacce estese.

Quando si eredita da Type, è necessario sottoporre a override i seguenti membri: 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) e GetCustomAttributes.

Nell'esempio di codice riportato di seguito vengono illustrate alcune funzionalità rappresentative dell'oggetto Type. L'operatore typeof di C# (GetType in Visual Basic, typeid in Visual C++) viene utilizzato per ottenere un oggetto Type che rappresenta l'oggetto String. Da questo oggetto Type, viene utilizzato il metodo GetMethod per ottenere un oggetto MethodInfo che rappresenta l'overload Substring che accetta una posizione di inizio e una lunghezza.

Per identificare la firma dell'overload, nell'esempio di codice viene creata una matrice temporanea contenente due oggetti Type che rappresentano int (Integer in Visual Basic).

Nota
Per la precisione, la matrice contiene due riferimenti all'istanza dell'oggetto Type che rappresenta int nel dominio applicazione corrente. Per qualsiasi tipo è presente solo un'unica istanza dell'oggetto Type per ciascun dominio applicazione.

Nell'esempio di codice viene utilizzato l'oggetto MethodInfo per richiamare il metodo Substring sulla stringa "Hello, World!" e viene visualizzato il risultato.

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

Libreria di classi portabile

.NET per applicazioni Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Questo tipo è thread-safe.

Riferimenti

Altre risorse