Type.GetType Metodo

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, Func<System::Reflection::AssemblyName ^, System::Reflection::Assembly ^> ^ assemblyResolver, Func<System::Reflection::Assembly ^, System::String ^, bool, Type ^> ^ typeResolver, bool throwOnError, bool ignoreCase);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")]
public static Type? GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver, bool throwOnError, bool ignoreCase);

public static Type GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly> assemblyResolver, Func<System.Reflection.Assembly,string,bool,Type> typeResolver, bool throwOnError, bool ignoreCase);

public static Type? GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver, bool throwOnError, bool ignoreCase);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")>]
static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> * bool * bool -> Type

static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> * bool * bool -> Type

Public Shared Function GetType (typeName As String, assemblyResolver As Func(Of AssemblyName, Assembly), typeResolver As Func(Of Assembly, String, Boolean, Type), throwOnError As Boolean, ignoreCase As Boolean) As Type

Parametri

Restituisce

Tipo con il nome specificato. Se il tipo non viene trovato, il throwOnError parametro specifica se null viene restituito o se viene generata un'eccezione. In alcuni casi, viene generata un'eccezione indipendentemente dal valore di throwOnError. Vedere la sezione Eccezioni.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

Commenti

In .NET Core 3.0 e versioni successive, se assemblyResolver è Null, i caricamenti dell'assembly attivati da questa API sono interessati dal valore corrente di AssemblyLoadContext.CurrentContextualReflectionContext.

Per altre informazioni su questa API, vedere Osservazioni supplementari sull'API per Type.GetType.

Origine:

Type.cs

Origine:

Type.cs

Origine:

Type.cs

Origine:

Type.cs

Origine:

Type.cs

public:
 Type ^ GetType();

public:
 virtual Type ^ GetType();

public Type GetType();

override this.GetType : unit -> Type

Public Function GetType () As Type

Restituisce

Oggetto corrente Type.

Implementazioni

Eccezioni

Vedi anche

• TypeLoadException
• Specifica dei nomi dei tipi completi

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName);

public static Type GetType(string typeName);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")]
public static Type? GetType(string typeName);

public static Type? GetType(string typeName);

static member GetType : string -> Type

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")>]
static member GetType : string -> Type

Public Shared Function GetType (typeName As String) As Type

Parametri

Restituisce

Tipo con il nome specificato, se trovato; in caso contrario, null.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

Esempio

Nell'esempio seguente viene recuperato il tipo di System.Int32 e viene utilizzato l'oggetto type per visualizzare la FullName proprietà di System.Int32.

using System;

class Example
{
     public static void Main()
     {
         try {
             // Get the type of a specified class.
             Type myType1 = Type.GetType("System.Int32");
             Console.WriteLine("The full name is {0}.\n", myType1.FullName);
         }
         catch (TypeLoadException e)
         {
            Console.WriteLine("{0}: Unable to load type System.Int32", e.GetType().Name);
         }

         try {
             // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
             Type myType2 = Type.GetType("NoneSuch", true);
             Console.WriteLine("The full name is {0}.", myType2.FullName);
         }
         catch(TypeLoadException e) {
            Console.WriteLine("{0}: Unable to load type NoneSuch", e.GetType().Name);
         }
     }
}
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

open System

try
    // Get the type of a specified class.
    let myType1 = Type.GetType "System.Int32"
    printfn $"The full name is {myType1.FullName}.\n"
with :? TypeLoadException as e ->
    printfn $"{e.GetType().Name}: Unable to load type System.Int32"

try
    // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
    let myType2 = Type.GetType("NoneSuch", true)
    printfn $"The full name is {myType2.FullName}."
with :? TypeLoadException as e ->
    printfn $"{e.GetType().Name}: Unable to load type NoneSuch"
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

Class Example
     Public Shared Sub Main()
         Try
             ' Get the type of the specified class.
             Dim myType1 As Type = Type.GetType("System.Int32")
             Console.WriteLine("The full name is {0}.", myType1.FullName)
         Catch e As TypeLoadException
             Console.WriteLine("{0}: Unable to load type System.Int32",
                               e.GetType().Name)
         End Try

         Console.WriteLine()

         Try
             ' Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
             Dim myType2 As Type = Type.GetType("NoneSuch", True)
             Console.WriteLine("The full name is {0}.", myType2.FullName)
         Catch e As TypeLoadException
             Console.WriteLine("{0}: Unable to load type NoneSuch", e.GetType().Name)
         End Try
     End Sub
End Class
' The example displays the following output:
'       The full name is System.Int32.
'
'       TypeLoadException: Unable to load type NoneSuch

Commenti

È possibile utilizzare il GetType metodo per ottenere un Type oggetto per un tipo in un altro assembly se si conosce il nome completo dell'assembly, che può essere ottenuto da AssemblyQualifiedName. GetType causa il caricamento dell'assembly specificato in typeName. È anche possibile caricare un assembly usando il Assembly.Load metodo e quindi usare il Assembly.GetType metodo o Assembly.GetTypes per ottenere Type oggetti. Se un tipo si trova in un assembly noto al programma in fase di compilazione, è più efficiente usare typeof in C# o l'operatore GetType in Visual Basic.

Solo .NET Framework: GetType funziona solo sugli assembly caricati dal disco. Se si chiama GetType per cercare un tipo definito in un assembly dinamico definito usando i System.Reflection.Emit servizi, è possibile che si verifichi un comportamento incoerente. Il comportamento dipende dal fatto che l'assembly dinamico sia persistente, ovvero creato usando le RunAndSave modalità di accesso o Save dell'enumerazione System.Reflection.Emit.AssemblyBuilderAccess . Se l'assembly dinamico è persistente ed è stato scritto su disco prima GetType della chiamata, il caricatore trova l'assembly salvato su disco, carica tale assembly e recupera il tipo da tale assembly. Se l'assembly non è stato salvato su disco quando GetType viene chiamato , il metodo restituisce null. GetType non comprende gli assembly dinamici temporanei; pertanto, la chiamata GetType a per recuperare un tipo in un assembly dinamico temporaneo restituisce null.

In .NET Framework, per usare GetType in un modulo dinamico, sottoscrivere l'evento AppDomain.AssemblyResolve e chiamare GetType prima di salvare. In caso contrario, si otterranno due copie dell'assembly in memoria.

In .NET Core 3.0 e versioni successive, i carichi di assembly attivati da questa API sono interessati dal valore corrente di AssemblyLoadContext.CurrentContextualReflectionContext.

Nella tabella seguente vengono illustrati i membri della classe base restituiti dai Get metodi quando si analizza un tipo.

Tipo di membro	Statico	Non statico
Costruttore	No	No
Campo	No	Sì. Un campo è sempre nascosto per nome e firma.
Event	Non applicabile	La regola di sistema dei tipi comune è che l'ereditarietà è uguale a quella dei metodi che implementano la proprietà . La reflection considera le proprietà come hide-by-name-and-signature. Vedere la nota 2 di seguito.
metodo	No	Sì. Un metodo (virtuale e non virtuale) può essere nascosto per nome o nascosto per nome e firma.
Tipo annidato	No	No
Proprietà	Non applicabile	La regola di sistema dei tipi comune è che l'ereditarietà è uguale a quella dei metodi che implementano la proprietà . La reflection considera le proprietà come hide-by-name-and-signature. Vedere la nota 2 di seguito.

1. Hide-by-name-and-signature considera tutte le parti della firma, inclusi modificatori personalizzati, tipi restituiti, tipi di parametro, sentinel e convenzioni di chiamata non gestite. Si tratta di un confronto binario.

2. In riflessione, le proprietà e gli eventi sono hide-by-name-and-signature. Se si dispone di una proprietà con una funzione di accesso get e set nella classe base, ma la classe derivata ha solo una funzione di accesso get, la proprietà della classe derivata nasconde la proprietà della classe base e non sarà possibile accedere al setter nella classe base.

3. Gli attributi personalizzati non fanno parte del sistema di tipi comune.

Le matrici o i tipi COM non vengono cercati a meno che non siano già stati caricati nella tabella delle classi disponibili.

typeName può essere il nome del tipo qualificato dallo spazio dei nomi o un nome completo dell'assembly che include una specifica del nome dell'assembly. Vedi AssemblyQualifiedName.

Se typeName include lo spazio dei nomi ma non il nome dell'assembly, questo metodo cerca solo l'assembly dell'oggetto chiamante e mscorlib.dll/System.Private.CoreLib.dll, in tale ordine. Se typeName è completo con il nome di assembly parziale o completo, questo metodo cerca nell'assembly specificato. Se l'assembly ha un nome sicuro, è necessario un nome assembly completo.

La AssemblyQualifiedName proprietà restituisce un nome di tipo completo, inclusi i tipi annidati, il nome dell'assembly e gli argomenti di tipo generico. Tutti i compilatori che supportano Common Language Runtime generano il nome semplice di una classe nidificata e la reflection costruisce un nome sbrogliato quando viene eseguita una query, in base alle convenzioni seguenti.

Delimitatore	Meaning
Barra rovesciata (\)	Carattere di escape.
Backtick (')	Precede una o più cifre che rappresentano il numero di parametri di tipo, che si trovano alla fine del nome di un tipo generico.
Parentesi quadre ([])	Racchiudere un elenco di argomenti di tipo generico per un tipo generico costruito; all'interno di un elenco di argomenti di tipo racchiudere un tipo qualificato dall'assembly.
Virgola (,)	Precede il nome dell'assembly.
Punto (.)	Indica gli identificatori dello spazio dei nomi.
Segno più (+)	Precede una classe nidificata.

Ad esempio, il nome completo di una classe potrebbe essere simile al seguente:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Se lo spazio dei nomi fosse TopNamespace.Sub+Namespace, la stringa dovrà precedere il segno più (+) con un carattere di escape (\) per evitare che venga interpretato come separatore di annidamento. La reflection genera questa stringa come segue:

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass,MyAssembly

"++" diventa "\+\+" e "\" diventa "\\".

Questo nome completo può essere salvato in modo permanente e usato in un secondo momento per caricare .Type Per cercare e caricare un Typeoggetto , usare GetType solo con il nome del tipo o con il nome completo dell'assembly. GetType con il nome del tipo cercherà Type solo nell'assembly del chiamante e quindi nell'assembly di sistema. GetType con il nome del tipo completo dell'assembly cercherà in Type qualsiasi assembly.

I nomi dei tipi possono includere caratteri finali che indicano informazioni aggiuntive sul tipo, ad esempio se il tipo è un tipo riferimento, un tipo di puntatore o un tipo di matrice. Per recuperare il nome del tipo senza questi caratteri finali, usare t.GetElementType().ToString(), dove t è il tipo .

Gli spazi sono rilevanti in tutti i componenti del nome del tipo, ad eccezione del nome dell'assembly. Nel nome dell'assembly gli spazi prima del separatore ',' sono rilevanti, ma gli spazi dopo il separatore ',' vengono ignorati.

Il nome di un tipo generico termina con un backtick (') seguito da cifre che rappresentano il numero di argomenti di tipo generico. Lo scopo di questo mangling del nome è consentire ai compilatori di supportare tipi generici con lo stesso nome, ma con numeri diversi di parametri di tipo, che si verificano nello stesso ambito. Ad esempio, la reflection restituisce i nomi Tuple`1 mangled e Tuple`2 dai metodi Tuple(Of T) generici e Tuple(Of T0, T1) in Visual Basic o Tuple<T> in Tuple<T0, T1> Visual C#.

Per i tipi generici, l'elenco di argomenti di tipo è racchiuso tra parentesi quadre e gli argomenti di tipo sono separati da virgole. Ad esempio, un generico Dictionary<TKey,TValue> ha due parametri di tipo. Un Dictionary<TKey,TValue> oggetto di MyType con chiavi di tipo String può essere rappresentato nel modo seguente:

System.Collections.Generic.Dictionary`2[System.String,MyType]

Per specificare un tipo qualificato dall'assembly all'interno di un elenco di argomenti di tipo, racchiudere il tipo qualificato dall'assembly tra parentesi quadre. In caso contrario, le virgole che separano le parti del nome qualificato dall'assembly vengono interpretate come delimitando argomenti di tipo aggiuntivi. Ad esempio, un Dictionary<TKey,TValue> di MyType fromMyAssembly.dll, con chiavi di tipo String, può essere specificato come segue:

Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAssembly]]")

I tipi nullable sono un caso speciale di tipi generici. Ad esempio, un valore nullable Int32 è rappresentato dalla stringa "System.Nullable'1[System.Int32]".

Nella tabella seguente viene illustrata la sintassi usata con GetType per vari tipi.

Ottenere	Utilizzo
Un valore nullable Int32	Type.GetType("System.Nullable`1[System.Int32]")
Puntatore non gestito a MyType	Type.GetType("MyType*")
Puntatore non gestito a un puntatore a MyType	Type.GetType("MyType**")
Puntatore gestito o riferimento a MyType	Type.GetType("MyType&"). Si noti che, a differenza dei puntatori, i riferimenti sono limitati a un livello.
Una classe padre e una classe nidificata	Type.GetType("MyParentClass+MyNestedClass")
Matrice unidimensionale con un limite inferiore pari a 0	Type.GetType("MyType[]")
Matrice unidimensionale con un limite inferiore sconosciuto	Type.GetType("MyType[*]")
Matrice ndimensionale	Una virgola (,) all'interno delle parentesi quadre è un totale di n-1 volte. Ad esempio, System.Object[,,] rappresenta una matrice tridimensionale Object .
Matrice di matrici unidimensionali	Type.GetType("MyType[][]")
Matrice bidimensionale rettangolare con limiti inferiori sconosciuti	Type.GetType("MyType[,]")
Tipo generico con un argomento di tipo	Type.GetType("MyGenericType`1[MyType]")
Tipo generico con due argomenti di tipo	Type.GetType("MyGenericType`2[MyType,AnotherType]")
Tipo generico con due argomenti di tipo qualificato dall'assembly	Type.GetType("MyGenericType`2[[MyType,MyAssembly],[AnotherType,AnotherAssembly]]")
Tipo generico qualificato dall'assembly con un argomento di tipo qualificato dall'assembly	Type.GetType("MyGenericType`1[[MyType,MyAssembly]],MyGenericTypeAssembly")
Tipo generico il cui argomento di tipo è un tipo generico con due argomenti di tipo	Type.GetType("MyGenericType`1[AnotherGenericType`2[MyType,AnotherType]]")

Vedi anche

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Specifica dei nomi dei tipi completi

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, bool throwOnError);

public static Type GetType(string typeName, bool throwOnError);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")]
public static Type? GetType(string typeName, bool throwOnError);

public static Type? GetType(string typeName, bool throwOnError);

static member GetType : string * bool -> Type

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")>]
static member GetType : string * bool -> Type

Public Shared Function GetType (typeName As String, throwOnError As Boolean) As Type

Parametri

Restituisce

Tipo con il nome specificato. Se il tipo non viene trovato, il throwOnError parametro specifica se null viene restituito o se viene generata un'eccezione. In alcuni casi, viene generata un'eccezione indipendentemente dal valore di throwOnError. Vedere la sezione Eccezioni.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

Esempio

Nell'esempio seguente viene recuperato il tipo di System.Int32 e viene utilizzato l'oggetto type per visualizzare la FullName proprietà di System.Int32. Se un oggetto di tipo fa riferimento a un assembly che non esiste, in questo esempio viene generata un'eccezione.

using System;

class Example
{
     public static void Main()
     {
         try {
             // Get the type of a specified class.
             Type myType1 = Type.GetType("System.Int32");
             Console.WriteLine("The full name is {0}.\n", myType1.FullName);
         }
         catch (TypeLoadException e)
         {
            Console.WriteLine("{0}: Unable to load type System.Int32", e.GetType().Name);
         }

         try {
             // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
             Type myType2 = Type.GetType("NoneSuch", true);
             Console.WriteLine("The full name is {0}.", myType2.FullName);
         }
         catch(TypeLoadException e) {
            Console.WriteLine("{0}: Unable to load type NoneSuch", e.GetType().Name);
         }
     }
}
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

open System

try
    // Get the type of a specified class.
    let myType1 = Type.GetType "System.Int32"
    printfn $"The full name is {myType1.FullName}.\n"
with :? TypeLoadException as e ->
    printfn $"{e.GetType().Name}: Unable to load type System.Int32"

try
    // Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
    let myType2 = Type.GetType("NoneSuch", true)
    printfn $"The full name is {myType2.FullName}."
with :? TypeLoadException as e ->
    printfn $"{e.GetType().Name}: Unable to load type NoneSuch"
// The example displays the following output:
//       The full name is System.Int32.
//
//       TypeLoadException: Unable to load type NoneSuch

Class Example
     Public Shared Sub Main()
         Try
             ' Get the type of the specified class.
             Dim myType1 As Type = Type.GetType("System.Int32")
             Console.WriteLine("The full name is {0}.", myType1.FullName)
         Catch e As TypeLoadException
             Console.WriteLine("{0}: Unable to load type System.Int32",
                               e.GetType().Name)
         End Try

         Console.WriteLine()

         Try
             ' Since NoneSuch does not exist in this assembly, GetType throws a TypeLoadException.
             Dim myType2 As Type = Type.GetType("NoneSuch", True)
             Console.WriteLine("The full name is {0}.", myType2.FullName)
         Catch e As TypeLoadException
             Console.WriteLine("{0}: Unable to load type NoneSuch", e.GetType().Name)
         End Try
     End Sub
End Class
' The example displays the following output:
'       The full name is System.Int32.
'
'       TypeLoadException: Unable to load type NoneSuch

Commenti

È possibile utilizzare il GetType metodo per ottenere un Type oggetto per un tipo in un altro assembly se si conosce il nome completo dell'assembly, che può essere ottenuto da AssemblyQualifiedName. GetType causa il caricamento dell'assembly specificato in typeName. È anche possibile caricare un assembly usando il Assembly.Load metodo e quindi usare il Assembly.GetType metodo o Assembly.GetTypes per ottenere Type oggetti. Se un tipo si trova in un assembly noto al programma in fase di compilazione, è più efficiente usare typeof in C# o l'operatore GetType in Visual Basic.

Solo .NET Framework: GetType funziona solo sugli assembly caricati dal disco. Se si chiama GetType per cercare un tipo definito in un assembly dinamico definito usando i System.Reflection.Emit servizi, è possibile che si verifichi un comportamento incoerente. Il comportamento dipende dal fatto che l'assembly dinamico sia persistente, ovvero creato usando le RunAndSave modalità di accesso o Save dell'enumerazione System.Reflection.Emit.AssemblyBuilderAccess . Se l'assembly dinamico è persistente ed è stato scritto su disco prima GetType della chiamata, il caricatore trova l'assembly salvato su disco, carica tale assembly e recupera il tipo da tale assembly. Se l'assembly non è stato salvato su disco quando GetType viene chiamato , il metodo restituisce null. GetType non comprende gli assembly dinamici temporanei; pertanto, la chiamata GetType a per recuperare un tipo in un assembly dinamico temporaneo restituisce null.

In .NET Framework, per usare GetType in un modulo dinamico, sottoscrivere l'evento AppDomain.AssemblyResolve e chiamare GetType prima di salvare. In caso contrario, si otterranno due copie dell'assembly in memoria.

In .NET Core 3.0 e versioni successive, i carichi di assembly attivati da questa API sono interessati dal valore corrente di AssemblyLoadContext.CurrentContextualReflectionContext.

Il throwOnError parametro specifica cosa accade quando il tipo non viene trovato e elimina anche determinate altre condizioni di eccezione, come descritto nella sezione Eccezioni. Alcune eccezioni vengono generate indipendentemente dal valore di throwOnError. Ad esempio, se il tipo viene trovato ma non può essere caricato, viene generata un'eccezione TypeLoadException anche se throwOnError è false.

Nella tabella seguente vengono illustrati i membri della classe base restituiti dai Get metodi quando si analizza un tipo.

Tipo di membro	Statico	Non statico
Costruttore	No	No
Campo	No	Sì. Un campo è sempre nascosto per nome e firma.
Event	Non applicabile	La regola di sistema dei tipi comune è che l'ereditarietà è uguale a quella dei metodi che implementano la proprietà . La reflection considera le proprietà come hide-by-name-and-signature. Vedere la nota 2 di seguito.
metodo	No	Sì. Un metodo (virtuale e non virtuale) può essere nascosto per nome o nascosto per nome e firma.
Tipo annidato	No	No
Proprietà	Non applicabile	La regola di sistema dei tipi comune è che l'ereditarietà è uguale a quella dei metodi che implementano la proprietà . La reflection considera le proprietà come hide-by-name-and-signature. Vedere la nota 2 di seguito.

1. Hide-by-name-and-signature considera tutte le parti della firma, inclusi modificatori personalizzati, tipi restituiti, tipi di parametro, sentinel e convenzioni di chiamata non gestite. Si tratta di un confronto binario.

2. In riflessione, le proprietà e gli eventi sono hide-by-name-and-signature. Se si dispone di una proprietà con una funzione di accesso get e set nella classe base, ma la classe derivata ha solo una funzione di accesso get, la proprietà della classe derivata nasconde la proprietà della classe base e non sarà possibile accedere al setter nella classe base.

3. Gli attributi personalizzati non fanno parte del sistema di tipi comune.

Le matrici o i tipi COM non vengono cercati a meno che non siano già stati caricati nella tabella delle classi disponibili.

typeName può essere il nome del tipo qualificato dallo spazio dei nomi o un nome completo dell'assembly che include una specifica del nome dell'assembly. Vedi AssemblyQualifiedName.

Se typeName include lo spazio dei nomi ma non il nome dell'assembly, questo metodo cerca solo l'assembly dell'oggetto chiamante e mscorlib.dll/System.Private.CoreLib.dll, in tale ordine. Se typeName è completo con il nome di assembly parziale o completo, questo metodo cerca nell'assembly specificato. Se l'assembly ha un nome sicuro, è necessario un nome assembly completo.

La AssemblyQualifiedName proprietà restituisce un nome di tipo completo, inclusi i tipi annidati, il nome dell'assembly e gli argomenti generici. Tutti i compilatori che supportano Common Language Runtime generano il nome semplice di una classe nidificata e la reflection costruisce un nome sbrogliato quando viene eseguita una query, in base alle convenzioni seguenti.

Delimitatore	Meaning
Barra rovesciata (\)	Carattere di escape.
Backtick (')	Precede una o più cifre che rappresentano il numero di parametri di tipo, che si trovano alla fine del nome di un tipo generico.
Parentesi quadre ([])	Racchiudere un elenco di argomenti di tipo generico per un tipo generico costruito; all'interno di un elenco di argomenti di tipo racchiudere un tipo qualificato dall'assembly.
Virgola (,)	Precede il nome dell'assembly.
Punto (.)	Indica gli identificatori dello spazio dei nomi.
Segno più (+)	Precede una classe nidificata.

Ad esempio, il nome completo di una classe potrebbe essere simile al seguente:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Se lo spazio dei nomi fosse TopNamespace.Sub+Namespace, la stringa dovrà precedere il segno più (+) con un carattere di escape (\) per evitare che venga interpretato come separatore di annidamento. La reflection genera questa stringa come segue:

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass,MyAssembly

"++" diventa "\+\+" e "\" diventa "\\".

Questo nome completo può essere salvato in modo permanente e usato in un secondo momento per caricare .Type Per cercare e caricare un Typeoggetto , usare GetType solo con il nome del tipo o con il nome completo dell'assembly. GetType con il nome del tipo cercherà Type solo nell'assembly del chiamante e quindi nell'assembly di sistema. GetType con il nome del tipo completo dell'assembly cercherà in Type qualsiasi assembly.

I nomi dei tipi possono includere caratteri finali che indicano informazioni aggiuntive sul tipo, ad esempio se il tipo è un tipo riferimento, un tipo di puntatore o un tipo di matrice. Per recuperare il nome del tipo senza questi caratteri finali, usare t.GetElementType().ToString(), dove t è il tipo .

Gli spazi sono rilevanti in tutti i componenti del nome del tipo, ad eccezione del nome dell'assembly. Nel nome dell'assembly gli spazi prima del separatore ',' sono rilevanti, ma gli spazi dopo il separatore ',' vengono ignorati.

Il nome di un tipo generico termina con un backtick (') seguito da cifre che rappresentano il numero di argomenti di tipo generico. Lo scopo di questo mangling del nome è consentire ai compilatori di supportare tipi generici con lo stesso nome, ma con numeri diversi di parametri di tipo, che si verificano nello stesso ambito. Ad esempio, la reflection restituisce i nomi Tuple`1 mangled e Tuple`2 dai metodi Tuple(Of T) generici e Tuple(Of T0, T1) in Visual Basic o Tuple<T> in Tuple<T0, T1> Visual C#.

Per i tipi generici, l'elenco di argomenti di tipo è racchiuso tra parentesi quadre e gli argomenti di tipo sono separati da virgole. Ad esempio, un generico Dictionary<TKey,TValue> ha due parametri di tipo. Un Dictionary<TKey,TValue> oggetto di MyType con chiavi di tipo String può essere rappresentato nel modo seguente:

System.Collections.Generic.Dictionary`2[System.String,MyType]

Per specificare un tipo qualificato dall'assembly all'interno di un elenco di argomenti di tipo, racchiudere il tipo qualificato dall'assembly tra parentesi quadre. In caso contrario, le virgole che separano le parti del nome qualificato dall'assembly vengono interpretate come delimitando argomenti di tipo aggiuntivi. Ad esempio, un Dictionary<TKey,TValue> oggetto di da MyType MyAssembly.dll, con chiavi di tipo String, può essere specificato come segue:

Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAssembly]]")

I tipi nullable sono un caso speciale di tipi generici. Ad esempio, un valore nullable Int32 è rappresentato dalla stringa "System.Nullable'1[System.Int32]".

Nella tabella seguente viene illustrata la sintassi usata con GetType per vari tipi.

Ottenere	Utilizzo
Un valore nullable Int32	Type.GetType("System.Nullable`1[System.Int32]")
Puntatore non gestito a MyType	Type.GetType("MyType*")
Puntatore non gestito a un puntatore a MyType	Type.GetType("MyType**")
Puntatore gestito o riferimento a MyType	Type.GetType("MyType&"). Si noti che, a differenza dei puntatori, i riferimenti sono limitati a un livello.
Una classe padre e una classe nidificata	Type.GetType("MyParentClass+MyNestedClass")
Matrice unidimensionale con un limite inferiore pari a 0	Type.GetType("MyArray[]")
Matrice unidimensionale con un limite inferiore sconosciuto	Type.GetType("MyArray[*]")
Matrice ndimensionale	Una virgola (,) all'interno delle parentesi quadre è un totale di n-1 volte. Ad esempio, System.Object[,,] rappresenta una matrice tridimensionale Object .
Matrice bidimensionale di una matrice	Type.GetType("MyArray[][]")
Matrice bidimensionale rettangolare con limiti inferiori sconosciuti	Type.GetType("MyArray[,]")
Tipo generico con un argomento di tipo	Type.GetType("MyGenericType`1[MyType]")
Tipo generico con due argomenti di tipo	Type.GetType("MyGenericType`2[MyType,AnotherType]")
Tipo generico con due argomenti di tipo qualificato dall'assembly	Type.GetType("MyGenericType`2[[MyType,MyAssembly],[AnotherType,AnotherAssembly]]")
Tipo generico qualificato dall'assembly con un argomento di tipo qualificato dall'assembly	Type.GetType("MyGenericType`1[[MyType,MyAssembly]],MyGenericTypeAssembly")
Tipo generico il cui argomento di tipo è un tipo generico con due argomenti di tipo	Type.GetType("MyGenericType`1[AnotherGenericType`2[MyType,AnotherType]]")

Vedi anche

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Specifica dei nomi dei tipi completi

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, bool throwOnError, bool ignoreCase);

public static Type GetType(string typeName, bool throwOnError, bool ignoreCase);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")]
public static Type? GetType(string typeName, bool throwOnError, bool ignoreCase);

public static Type? GetType(string typeName, bool throwOnError, bool ignoreCase);

static member GetType : string * bool * bool -> Type

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")>]
static member GetType : string * bool * bool -> Type

Public Shared Function GetType (typeName As String, throwOnError As Boolean, ignoreCase As Boolean) As Type

Parametri

Restituisce

Tipo con il nome specificato. Se il tipo non viene trovato, il throwOnError parametro specifica se null viene restituito o se viene generata un'eccezione. In alcuni casi, viene generata un'eccezione indipendentemente dal valore di throwOnError. Vedere la sezione Eccezioni.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

Commenti

È possibile utilizzare il GetType metodo per ottenere un Type oggetto per un tipo in un altro assembly se si conosce il nome completo dell'assembly, che può essere ottenuto da AssemblyQualifiedName. GetType causa il caricamento dell'assembly specificato in typeName. È anche possibile caricare un assembly usando il Assembly.Load metodo e quindi usare il Assembly.GetType metodo o Assembly.GetTypes per ottenere Type oggetti. Se un tipo si trova in un assembly noto al programma in fase di compilazione, è più efficiente usare typeof in C# o l'operatore GetType in Visual Basic.

Solo .NET Framework: GetType funziona solo sugli assembly caricati dal disco. Se si chiama GetType per cercare un tipo definito in un assembly dinamico definito usando i System.Reflection.Emit servizi, è possibile che si verifichi un comportamento incoerente. Il comportamento dipende dal fatto che l'assembly dinamico sia persistente, ovvero creato usando le RunAndSave modalità di accesso o Save dell'enumerazione System.Reflection.Emit.AssemblyBuilderAccess . Se l'assembly dinamico è persistente ed è stato scritto su disco prima GetType della chiamata, il caricatore trova l'assembly salvato su disco, carica tale assembly e recupera il tipo da tale assembly. Se l'assembly non è stato salvato su disco quando GetType viene chiamato , il metodo restituisce null. GetType non comprende gli assembly dinamici temporanei; pertanto, la chiamata GetType a per recuperare un tipo in un assembly dinamico temporaneo restituisce null.

In .NET Framework, per usare GetType in un modulo dinamico, sottoscrivere l'evento AppDomain.AssemblyResolve e chiamare GetType prima di salvare. In caso contrario, si otterranno due copie dell'assembly in memoria.

In .NET Core 3.0 e versioni successive, i carichi di assembly attivati da questa API sono interessati dal valore corrente di AssemblyLoadContext.CurrentContextualReflectionContext.

Il throwOnError parametro specifica cosa accade quando il tipo non viene trovato e elimina anche determinate altre condizioni di eccezione, come descritto nella sezione Eccezioni. Alcune eccezioni vengono generate indipendentemente dal valore di throwOnError. Ad esempio, se il tipo viene trovato ma non può essere caricato, viene generata un'eccezione TypeLoadException anche se throwOnError è false.

Nella tabella seguente vengono illustrati i membri della classe base restituiti dai Get metodi quando si analizza un tipo.

Tipo di membro	Statico	Non statico
Costruttore	No	No
Campo	No	Sì. Un campo è sempre nascosto per nome e firma.
Event	Non applicabile	La regola di sistema dei tipi comune è che l'ereditarietà è uguale a quella dei metodi che implementano la proprietà . La reflection considera le proprietà come hide-by-name-and-signature. Vedere la nota 2 di seguito.
metodo	No	Sì. Un metodo (virtuale e non virtuale) può essere nascosto per nome o nascosto per nome e firma.
Tipo annidato	No	No
Proprietà	Non applicabile	La regola di sistema dei tipi comune è che l'ereditarietà è uguale a quella dei metodi che implementano la proprietà . La reflection considera le proprietà come hide-by-name-and-signature. Vedere la nota 2 di seguito.

1. Hide-by-name-and-signature considera tutte le parti della firma, inclusi modificatori personalizzati, tipi restituiti, tipi di parametro, sentinel e convenzioni di chiamata non gestite. Si tratta di un confronto binario.

2. In riflessione, le proprietà e gli eventi sono hide-by-name-and-signature. Se si dispone di una proprietà con una funzione di accesso get e set nella classe base, ma la classe derivata ha solo una funzione di accesso get, la proprietà della classe derivata nasconde la proprietà della classe base e non sarà possibile accedere al setter nella classe base.

3. Gli attributi personalizzati non fanno parte del sistema di tipi comune.

Le matrici o i tipi COM non vengono cercati a meno che non siano già stati caricati nella tabella delle classi disponibili.

typeName può essere il nome del tipo qualificato dallo spazio dei nomi o un nome completo dell'assembly che include una specifica del nome dell'assembly. Vedi AssemblyQualifiedName.

Se typeName include lo spazio dei nomi ma non il nome dell'assembly, questo metodo cerca solo l'assembly dell'oggetto chiamante e mscorlib.dll/System.Private.CoreLib.dll, in tale ordine. Se typeName è completo con il nome di assembly parziale o completo, questo metodo cerca nell'assembly specificato. Se l'assembly ha un nome sicuro, è necessario un nome assembly completo.

La AssemblyQualifiedName proprietà restituisce un nome di tipo completo, inclusi i tipi annidati, il nome dell'assembly e gli argomenti di tipo. Tutti i compilatori che supportano Common Language Runtime generano il nome semplice di una classe nidificata e la reflection costruisce un nome sbrogliato quando viene eseguita una query, in base alle convenzioni seguenti.

Delimitatore	Meaning
Barra rovesciata (\)	Carattere di escape.
Backtick (')	Precede una o più cifre che rappresentano il numero di parametri di tipo, che si trovano alla fine del nome di un tipo generico.
Parentesi quadre ([])	Racchiudere un elenco di argomenti di tipo generico per un tipo generico costruito; all'interno di un elenco di argomenti di tipo racchiudere un tipo qualificato dall'assembly.
Virgola (,)	Precede il nome dell'assembly.
Punto (.)	Indica gli identificatori dello spazio dei nomi.
Segno più (+)	Precede una classe nidificata.

Ad esempio, il nome completo di una classe potrebbe essere simile al seguente:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Se lo spazio dei nomi fosse TopNamespace.Sub+Namespace, la stringa dovrà precedere il segno più (+) con un carattere di escape (\) per evitare che venga interpretato come separatore di annidamento. La reflection genera questa stringa come segue:

TopNamespace.Sub\+Namespace.ContainingClass+NestedClass,MyAssembly

"++" diventa "\+\+" e "\" diventa "\\".

Questo nome completo può essere salvato in modo permanente e usato in un secondo momento per caricare .Type Per cercare e caricare un Typeoggetto , usare GetType solo con il nome del tipo o con il nome completo dell'assembly. GetType con il nome del tipo cercherà Type solo nell'assembly del chiamante e quindi nell'assembly di sistema. GetType con il nome del tipo completo dell'assembly cercherà in Type qualsiasi assembly.

I nomi dei tipi possono includere caratteri finali che indicano informazioni aggiuntive sul tipo, ad esempio se il tipo è un tipo riferimento, un tipo di puntatore o un tipo di matrice. Per recuperare il nome del tipo senza questi caratteri finali, usare t.GetElementType().ToString(), dove t è il tipo .

Gli spazi sono rilevanti in tutti i componenti del nome del tipo, ad eccezione del nome dell'assembly. Nel nome dell'assembly gli spazi prima del separatore ',' sono rilevanti, ma gli spazi dopo il separatore ',' vengono ignorati.

Il nome di un tipo generico termina con un backtick (') seguito da cifre che rappresentano il numero di argomenti di tipo generico. Lo scopo di questo mangling del nome è consentire ai compilatori di supportare tipi generici con lo stesso nome, ma con numeri diversi di parametri di tipo, che si verificano nello stesso ambito. Ad esempio, la reflection restituisce i nomi Tuple`1 mangled e Tuple`2 dai metodi Tuple(Of T) generici e Tuple(Of T0, T1) in Visual Basic o Tuple<T> in Tuple<T0, T1> Visual C#.

Per i tipi generici, l'elenco di argomenti di tipo è racchiuso tra parentesi quadre e gli argomenti di tipo sono separati da virgole. Ad esempio, un generico Dictionary<TKey,TValue> ha due parametri di tipo. Un Dictionary<TKey,TValue> oggetto di MyType con chiavi di tipo String può essere rappresentato nel modo seguente:

System.Collections.Generic.Dictionary`2[System.String,MyType]

Per specificare un tipo qualificato dall'assembly all'interno di un elenco di argomenti di tipo, racchiudere il tipo qualificato dall'assembly tra parentesi quadre. In caso contrario, le virgole che separano le parti del nome qualificato dall'assembly vengono interpretate come delimitando argomenti di tipo aggiuntivi. Ad esempio, un Dictionary<TKey,TValue> oggetto di da MyType MyAssembly.dll, con chiavi di tipo String, può essere specificato come segue:

Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAssembly]]")

I tipi nullable sono un caso speciale di tipi generici. Ad esempio, un valore nullable Int32 è rappresentato dalla stringa "System.Nullable'1[System.Int32]".

Nella tabella seguente viene illustrata la sintassi usata con GetType per vari tipi.

Ottenere	Utilizzo
Un valore nullable Int32	Type.GetType("System.Nullable`1[System.Int32]")
Puntatore non gestito a MyType	Type.GetType("MyType*")
Puntatore non gestito a un puntatore a MyType	Type.GetType("MyType**")
Puntatore gestito o riferimento a MyType	Type.GetType("MyType&"). Si noti che, a differenza dei puntatori, i riferimenti sono limitati a un livello.
Una classe padre e una classe nidificata	Type.GetType("MyParentClass+MyNestedClass")
Matrice unidimensionale con un limite inferiore pari a 0	Type.GetType("MyArray[]")
Matrice unidimensionale con un limite inferiore sconosciuto	Type.GetType("MyArray[*]")
Matrice ndimensionale	Una virgola (,) all'interno delle parentesi quadre è un totale di n-1 volte. Ad esempio, System.Object[,,] rappresenta una matrice tridimensionale Object .
Matrice bidimensionale di una matrice	Type.GetType("MyArray[][]")
Matrice bidimensionale rettangolare con limiti inferiori sconosciuti	Type.GetType("MyArray[,]")
Tipo generico con un argomento di tipo	Type.GetType("MyGenericType`1[MyType]")
Tipo generico con due argomenti di tipo	Type.GetType("MyGenericType`2[MyType,AnotherType]")
Tipo generico con due argomenti di tipo qualificato dall'assembly	Type.GetType("MyGenericType`2[[MyType,MyAssembly],[AnotherType,AnotherAssembly]]")
Tipo generico qualificato dall'assembly con un argomento di tipo qualificato dall'assembly	Type.GetType("MyGenericType`1[[MyType,MyAssembly]],MyGenericTypeAssembly")
Tipo generico il cui argomento di tipo è un tipo generico con due argomenti di tipo	Type.GetType("MyGenericType`1[AnotherGenericType`2[MyType,AnotherType]]")

Vedi anche

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Specifica dei nomi dei tipi completi

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, Func<System::Reflection::AssemblyName ^, System::Reflection::Assembly ^> ^ assemblyResolver, Func<System::Reflection::Assembly ^, System::String ^, bool, Type ^> ^ typeResolver);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")]
public static Type? GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver);

public static Type GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly> assemblyResolver, Func<System.Reflection.Assembly,string,bool,Type> typeResolver);

public static Type? GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")>]
static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> -> Type

static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> -> Type

Public Shared Function GetType (typeName As String, assemblyResolver As Func(Of AssemblyName, Assembly), typeResolver As Func(Of Assembly, String, Boolean, Type)) As Type

Parametri

Restituisce

Tipo con il nome specificato o null se il tipo non viene trovato.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

Commenti

Gli scenari di utilizzo per questo metodo e i dettagli sui assemblyResolver parametri e typeResolver sono disponibili nell'overload del GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) metodo.

La chiamata a questo overload del metodo equivale a chiamare l'overload del GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) metodo e specificare false per i throwOnError parametri e ignoreCase .

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

Origine:

Type.CoreCLR.cs

public:
 static Type ^ GetType(System::String ^ typeName, Func<System::Reflection::AssemblyName ^, System::Reflection::Assembly ^> ^ assemblyResolver, Func<System::Reflection::Assembly ^, System::String ^, bool, Type ^> ^ typeResolver, bool throwOnError);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")]
public static Type? GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver, bool throwOnError);

public static Type GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly> assemblyResolver, Func<System.Reflection.Assembly,string,bool,Type> typeResolver, bool throwOnError);

public static Type? GetType(string typeName, Func<System.Reflection.AssemblyName,System.Reflection.Assembly?>? assemblyResolver, Func<System.Reflection.Assembly?,string,bool,Type?>? typeResolver, bool throwOnError);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The type might be removed")>]
static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> * bool -> Type

static member GetType : string * Func<System.Reflection.AssemblyName, System.Reflection.Assembly> * Func<System.Reflection.Assembly, string, bool, Type> * bool -> Type

Public Shared Function GetType (typeName As String, assemblyResolver As Func(Of AssemblyName, Assembly), typeResolver As Func(Of Assembly, String, Boolean, Type), throwOnError As Boolean) As Type

Parametri

Restituisce

Tipo con il nome specificato. Se il tipo non viene trovato, il throwOnError parametro specifica se null viene restituito o se viene generata un'eccezione. In alcuni casi, viene generata un'eccezione indipendentemente dal valore di throwOnError. Vedere la sezione Eccezioni.

Attributi

RequiresUnreferencedCodeAttribute

Eccezioni

Commenti

Gli scenari di utilizzo per questo metodo e i dettagli sui assemblyResolver parametri e typeResolver sono disponibili nell'overload del GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) metodo.

La chiamata a questo overload del metodo equivale a chiamare l'overload del GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) metodo e specificare false per il ignoreCase parametro .