Type.GetType Metodo

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);

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);

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 parametro throwOnError specifica se viene restituito null o se viene generata un'eccezione. In alcuni casi, viene generata un'eccezione indipendentemente dal valore di throwOnError. Vedere la sezione relativa alle eccezioni.

Eccezioni

Commenti

Per altre informazioni su questa API, vedere Note sulle API supplementari per Type.GetType.

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 Type corrente.

Implementazioni

Eccezioni

Vedi anche

• TypeLoadException
• Specifica dei nomi di tipi completi

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);

public static Type? GetType (string typeName);

static member GetType : string -> Type

Public Shared Function GetType (typeName As String) As Type

Parametri

Restituisce

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

Eccezioni

Esempio

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

using namespace System;

int 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

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.

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 assembly dinamici temporanei; pertanto, la chiamata GetType per recuperare un tipo in un assembly dinamico temporaneo restituisce null.

Per usarlo GetType in un modulo dinamico, sottoscrivere l'evento e chiamare GetType prima del AppDomain.AssemblyResolve salvataggio. In caso contrario, si otterranno due copie dell'assembly in memoria.

Nella tabella seguente vengono illustrati i membri di una classe base restituiti dai Get metodi quando si riflette su un tipo.

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

2. Per la reflection, le proprietà e gli eventi sono nascondi per nome e firma. Se si dispone di una proprietà con una funzione di accesso get e un set nella classe base, ma la classe derivata ha solo una funzione di accesso get, la proprietà 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 comuni.

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 qualificato per assembly che include una specifica del nome dell'assembly. Vedere 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 dell'assembly parziale o completo, questo metodo cerca nell'assembly specificato. Se l'assembly ha un nome sicuro, è necessario un nome di assembly completo.

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

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

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

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

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

Un "++" diventa "\+\+", e "\" diventa "\\".

Questo nome qualificato può essere persistente e usato in un secondo momento per caricare l'oggetto Type. Per cercare e caricare un Typeoggetto , usare GetType solo con il nome del tipo o con il nome del tipo qualificato dell'assembly. GetType con il nome del tipo cercherà solo l'assembly Type del chiamante e quindi nell'assembly di sistema. GetType con il nome del tipo qualificato 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 di 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 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 dai metodi Tuple(Of T) generici e Tuple`2Tuple(Of T0, T1) in Visual Basic o Tuple<T0, T1>Tuple<T> in Visual C#.

Per i tipi generici, l'elenco degli 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. Una Dictionary<TKey,TValue> di con chiavi di MyType tipo String può essere rappresentata come segue:

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

Per specificare un tipo qualificato per assembly all'interno di un elenco di argomenti di tipo, racchiudere il tipo qualificato dell'assembly tra parentesi quadre. In caso contrario, le virgole che separano le parti del nome qualificato dell'assembly vengono interpretate come delimitazioni di argomenti di tipo aggiuntivi. Ad esempio, un Dictionary<TKey,TValue> oggetto di fromMyAssembly.dll, con chiavi di MyType 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 è rappresentato dalla stringa "System.Nullable'1 Int32 [System.Int32]".

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

Vedi anche

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

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);

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

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 parametro throwOnError specifica se viene restituito null o se viene generata un'eccezione. In alcuni casi, viene generata un'eccezione indipendentemente dal valore di throwOnError. Vedere la sezione relativa alle eccezioni.

Eccezioni

Esempio

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

using namespace System;

int 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

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.

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 per recuperare un tipo in un assembly dinamico temporaneo restituisce null.

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.

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 di una classe base restituiti dai Get metodi quando si riflette su un tipo.

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. Per la reflection, le proprietà e gli eventi sono hide-by-name-and-signature. Se nella classe base è presente una proprietà con una funzione di accesso get e una funzione di accesso set, 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 comuni.

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 dal relativo spazio dei nomi o un nome qualificato dall'assembly che include una specifica del nome dell'assembly. Vedere 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 dell'assembly parziale o completo, questo metodo esegue la ricerca 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 annidata e la reflection costruisce un nome mangled quando viene eseguita una query, in base alle convenzioni seguenti.

Ad esempio, il nome completo per 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 impedire 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 seguito per caricare l'oggetto Type. Per cercare e caricare un Typeoggetto , usare GetType solo con il nome del tipo o con il nome del tipo 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 di tipo completo dell'assembly Type cercherà in 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> e Tuple<T0, T1> in 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 come segue:

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 completo dell'assembly vengono interpretate come delimitando argomenti di tipo aggiuntivi. Ad esempio, un Dictionary<TKey,TValue> 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.

Vedi anche

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

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);

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

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 parametro throwOnError specifica se viene restituito null o se viene generata un'eccezione. In alcuni casi, viene generata un'eccezione indipendentemente dal valore di throwOnError. Vedere la sezione relativa alle eccezioni.

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.

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 per recuperare un tipo in un assembly dinamico temporaneo restituisce null.

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.

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 di una classe base restituiti dai Get metodi quando si riflette su un tipo.

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. Per la reflection, le proprietà e gli eventi sono hide-by-name-and-signature. Se nella classe base è presente una proprietà con una funzione di accesso get e una funzione di accesso set, 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 comuni.

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 dal relativo spazio dei nomi o un nome qualificato dall'assembly che include una specifica del nome dell'assembly. Vedere 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 dell'assembly parziale o completo, questo metodo esegue la ricerca 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 annidata e la reflection costruisce un nome mangled quando viene eseguita una query, in base alle convenzioni seguenti.

Ad esempio, il nome completo per 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 impedire 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 seguito per caricare l'oggetto Type. Per cercare e caricare un Typeoggetto , usare GetType solo con il nome del tipo o con il nome del tipo 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 di tipo completo dell'assembly Type cercherà in 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 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 dai metodi Tuple(Of T) generici e Tuple`2Tuple(Of T0, T1) in Visual Basic o Tuple<T0, T1>Tuple<T> in Visual C#.

Per i tipi generici, l'elenco degli 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. Una Dictionary<TKey,TValue> di con chiavi di MyType tipo String può essere rappresentata come segue:

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

Per specificare un tipo qualificato per assembly all'interno di un elenco di argomenti di tipo, racchiudere il tipo qualificato dell'assembly tra parentesi quadre. In caso contrario, le virgole che separano le parti del nome qualificato dell'assembly vengono interpretate come delimitazioni di argomenti di tipo aggiuntivi. Ad esempio, un Dictionary<TKey,TValue> oggetto di 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 è rappresentato dalla stringa "System.Nullable'1 Int32 [System.Int32]".

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

Vedi anche

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

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);

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);

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, oppure null se il tipo non viene trovato.

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 all'overload di questo metodo è uguale a quella di chiamare l'overload del GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) metodo e specificando false per i throwOnError parametri e ignoreCase .

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);

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);

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 parametro throwOnError specifica se viene restituito null o se viene generata un'eccezione. In alcuni casi, viene generata un'eccezione indipendentemente dal valore di throwOnError. Vedere la sezione relativa alle eccezioni.

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 di questo overload del metodo è uguale a quella di chiamare l'overload del GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) metodo e specificare false per il ignoreCase parametro.