Type.GetType Metoda

Zdroj:

Type.CoreCLR.cs

Zdroj:

Type.CoreCLR.cs

Zdroj:

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

Parametry

Návraty

Typ se zadaným názvem. Pokud typ není nalezen, parametr určuje, throwOnError zda null je vrácen nebo je vyvolán výjimka. V některých případech dojde k výjimce bez ohledu na hodnotu parametru throwOnError. Viz část Výjimky.

Výjimky

Poznámky

Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky k rozhraní API pro Type.GetType.

Zdroj:

Type.cs

Zdroj:

Type.cs

Zdroj:

Type.cs

public:
 Type ^ GetType();

public:
 virtual Type ^ GetType();

public Type GetType ();

override this.GetType : unit -> Type

Public Function GetType () As Type

Návraty

Aktuální Typehodnota .

Implementuje

Výjimky

Viz také

• TypeLoadException
• Určení úplných názvů typů

Zdroj:

Type.CoreCLR.cs

Zdroj:

Type.CoreCLR.cs

Zdroj:

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

Parametry

Návraty

Typ se zadaným názvem, pokud je nalezen; v opačném případě . null

Výjimky

Příklady

Následující příklad načte typ objektu System.Int32 a použije tento typ objektu FullName k zobrazení vlastnosti 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

Poznámky

Můžete použít metodu GetType k získání objektu Type pro typ v jiném sestavení, pokud znáte jeho název kvalifikovaný pro sestavení, který lze získat z AssemblyQualifiedName. GetType způsobí načtení sestavení zadaného v typeName. Sestavení můžete také načíst pomocí Assembly.Load metody a pak pomocí Assembly.GetType metody nebo Assembly.GetTypes získat Type objekty. Pokud je typ v sestavení známém programem v době kompilace, je efektivnější ho použít typeof v jazyce C# nebo operátor v GetType jazyce Visual Basic.

GetType funguje pouze u sestavení načtených z disku. Pokud zavoláte GetType k vyhledání typu definovaného v dynamickém sestavení definovaném System.Reflection.Emit pomocí služeb, může dojít k nekonzistentnímu chování. Toto chování závisí na tom, zda dynamické sestavení je trvalé, tj. vytvořené pomocí RunAndSave režimů přístupu nebo Save výčtu System.Reflection.Emit.AssemblyBuilderAccess . Pokud je dynamické sestavení trvalé a bylo zapsáno na disk před GetType zavolání, zavaděč najde uložené sestavení na disku, načte toto sestavení a načte typ z daného sestavení. Pokud sestavení nebylo při volání uloženo na disk GetType , vrátí nullmetoda . GetType nerozumí přechodným dynamickým sestavením; Proto volání GetType pro načtení typu v přechodném dynamickém sestavení vrátí null.

Pokud chcete použít GetType v dynamickém modulu, přihlaste se k odběru události a před uložením AppDomain.AssemblyResolve zavolejte GetType . V opačném případě získáte dvě kopie sestavení v paměti.

Následující tabulka ukazuje, jaké členy základní třídy jsou vráceny metodami Get při odrazu na typu.

1. Skrývání podle názvu a podpisu bere v úvahu všechny části podpisu včetně vlastních modifikátorů, návratových typů, typů parametrů, sentinelů a nespravovaných konvencí volání. Jedná se o binární porovnání.

2. Pro účely reflexe jsou vlastnosti a události skrývány podle názvu a podpisu. Má-li vlastnost v základní třídě přístupové metody get i set, ale odvozená třída má pouze přístupovou metodu get, vlastnost odvozené třídy skryje vlastnost základní třídy a nebudete mít k dispozici přístup k metodě set základní třídy.

3. Vlastní atributy nejsou součástí systému společných typů.

Pole nebo typy modelu COM se nehledají, pokud již nebyly načteny do tabulky dostupných tříd.

typeName může být název typu kvalifikovaný jeho oborem názvů nebo název kvalifikovaný pro sestavení, který obsahuje specifikaci názvu sestavení. Viz třída AssemblyQualifiedName.

Pokud typeName obsahuje obor názvů, ale ne název sestavení, tato metoda prohledá pouze sestavení volajícího objektu a mscorlib.dll/System.Private.CoreLib.dll v tomto pořadí. Pokud je typeName plně kvalifikovaný s částečným nebo úplným názvem sestavení, tato metoda vyhledá v zadaném sestavení. Pokud má sestavení silný název, je vyžadován úplný název sestavení.

Vlastnost AssemblyQualifiedName vrátí plně kvalifikovaný název typu, včetně vnořených typů, názvu sestavení a obecných argumentů typu. Všechny kompilátory, které podporují modul Common Language Runtime, vygenerují jednoduchý název vnořené třídy a reflexe při dotazu sestaví pozměněný název podle následujících pravidel.

Plně kvalifikovaný název třídy může vypadat například takto:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Pokud by obor názvů byl TopNamespace.Sub+Namespace, řetězec by musel před znakem plus (+) zadat řídicí znak (\), aby se zabránilo jeho interpretaci jako oddělovače vnoření. Reflexe vygeneruje tento řetězec následujícím způsobem:

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

Výraz "++" se změní na \+\+" a "\" na "\\".

Tento kvalifikovaný název lze zachovat a později použít k načtení Type. Pokud chcete vyhledat a načíst Type, použijte GetType buď jenom s názvem typu, nebo s názvem kvalifikovaného typu sestavení. GetType s názvem typu bude hledat Type pouze v sestavení volajícího a pak v sestavení Systému. GetType s názvem kvalifikovaného typu sestavení vyhledá v libovolném Type sestavení.

Názvy typů mohou obsahovat koncové znaky poskytující další informace o typu, například zda se jedná o typ ukazatele, odkazu nebo pole. Pokud chcete načíst název typu bez těchto koncových znaků, použijte t.GetElementType().ToString(), kde t je typ.

Mezery jsou brány v úvahu ve všech součástech názvu typu s výjimkou názvu sestavení. V názvu sestavení jsou brány v úvahu mezery před oddělovačem ',', zatímco mezery za oddělovačem ',' jsou ignorovány.

Název obecného typu končí zpětným znakem (') následovaným číslicemi představujícími počet argumentů obecného typu. Účelem tohoto manglingu názvů je umožnit kompilátorům podporovat obecné typy se stejným názvem, ale s různými počty parametrů typu, které se vyskytují ve stejném oboru. Reflexe například vrátí zkamenělé názvy Tuple`1 a Tuple`2 z obecných metod Tuple(Of T) a Tuple(Of T0, T1) v jazyce Visual Basic nebo Tuple<T> a Tuple<T0, T1> v jazyce Visual C#.

U obecných typů je seznam argumentů typu uzavřený v závorkách a argumenty typu jsou oddělené čárkami. Například obecný Dictionary<TKey,TValue> má dva parametry typu. Hodnota A Dictionary<TKey,TValue> s MyType klíči typu String může být reprezentována následujícím způsobem:

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

Chcete-li v seznamu argumentů typu určit typ kvalifikovaný pro sestavení, uzavřete typ kvalifikovaný pro sestavení do závorek. Jinak jsou čárky, které oddělují části kvalifikovaného názvu sestavení, interpretovány jako oddělovače dalších argumentů typu. Například Dictionary<TKey,TValue>MyType fromMyAssembly.dll s klíči typu Stringmůže být zadán takto:

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

Typy s možnou hodnotou null jsou speciálním případem obecných typů. Například hodnota nullable Int32 je reprezentována řetězcem "System.Nullable'1[System.Int32]".

Následující tabulka ukazuje syntaxi, kterou GetType používáte pro různé typy.

Viz také

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Určení úplných názvů typů

Zdroj:

Type.CoreCLR.cs

Zdroj:

Type.CoreCLR.cs

Zdroj:

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

Parametry

Návraty

Typ se zadaným názvem. Pokud typ není nalezen, parametr určuje, throwOnError zda null je vrácen nebo je vyvolán výjimka. V některých případech dojde k výjimce bez ohledu na hodnotu parametru throwOnError. Viz část Výjimky.

Výjimky

Příklady

Následující příklad načte typ objektu System.Int32 a použije tento typ objektu FullName k zobrazení vlastnosti System.Int32. Pokud objekt typu odkazuje na sestavení, které neexistuje, tento příklad vyvolá výjimku.

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

Poznámky

Můžete použít metodu GetType k získání objektu Type pro typ v jiném sestavení, pokud znáte jeho název kvalifikovaný pro sestavení, který lze získat z AssemblyQualifiedName. GetType způsobí načtení sestavení zadaného v typeName. Sestavení můžete také načíst pomocí Assembly.Load metody a pak pomocí Assembly.GetType metody nebo Assembly.GetTypes získat Type objekty. Pokud je typ v sestavení známém programem v době kompilace, je efektivnější ho použít typeof v jazyce C# nebo operátor v GetType jazyce Visual Basic.

GetType funguje pouze u sestavení načtených z disku. Pokud zavoláte GetType k vyhledání typu definovaného v dynamickém sestavení definovaném System.Reflection.Emit pomocí služeb, může dojít k nekonzistentnímu chování. Toto chování závisí na tom, zda dynamické sestavení je trvalé, tj. vytvořené pomocí RunAndSave režimů přístupu nebo Save výčtu System.Reflection.Emit.AssemblyBuilderAccess . Pokud je dynamické sestavení trvalé a bylo zapsáno na disk před GetType zavolání, zavaděč najde uložené sestavení na disku, načte toto sestavení a načte typ z daného sestavení. Pokud sestavení nebylo při volání uloženo na disk GetType , vrátí nullmetoda . GetType nerozumí přechodným dynamickým sestavením; Proto volání GetType pro načtení typu v přechodném dynamickém sestavení vrátí null.

Pokud chcete použít GetType v dynamickém modulu, přihlaste se k odběru události a před uložením AppDomain.AssemblyResolve zavolejte GetType . V opačném případě získáte dvě kopie sestavení v paměti.

Parametr throwOnError určuje, co se stane, když typ není nalezen, a také potlačuje určité další podmínky výjimky, jak je popsáno v části Výjimky. Některé výjimky jsou vyvolány bez ohledu na hodnotu parametru throwOnError. Pokud je například typ nalezen, ale nelze ho načíst, vyvolá se i v případě, TypeLoadException že throwOnError je false.

Následující tabulka ukazuje, jaké členy základní třídy jsou vráceny metodami Get při odrazu na typu.

1. Skrývání podle názvu a podpisu bere v úvahu všechny části podpisu včetně vlastních modifikátorů, návratových typů, typů parametrů, sentinelů a nespravovaných konvencí volání. Jedná se o binární porovnání.

2. Pro účely reflexe jsou vlastnosti a události skrývány podle názvu a podpisu. Má-li vlastnost v základní třídě přístupové metody get i set, ale odvozená třída má pouze přístupovou metodu get, vlastnost odvozené třídy skryje vlastnost základní třídy a nebudete mít k dispozici přístup k metodě set základní třídy.

3. Vlastní atributy nejsou součástí systému společných typů.

Pole nebo typy modelu COM se nehledají, pokud již nebyly načteny do tabulky dostupných tříd.

typeName může být název typu kvalifikovaný jeho oborem názvů nebo název kvalifikovaný pro sestavení, který obsahuje specifikaci názvu sestavení. Viz třída AssemblyQualifiedName.

Pokud typeName obsahuje obor názvů, ale ne název sestavení, tato metoda prohledá pouze sestavení volajícího objektu a mscorlib.dll/System.Private.CoreLib.dll v tomto pořadí. Pokud je typeName plně kvalifikovaný s částečným nebo úplným názvem sestavení, tato metoda vyhledá v zadaném sestavení. Pokud má sestavení silný název, je vyžadován úplný název sestavení.

Vlastnost AssemblyQualifiedName vrátí plně kvalifikovaný název typu včetně vnořených typů, názvu sestavení a obecných argumentů. Všechny kompilátory, které podporují modul Common Language Runtime, vygenerují jednoduchý název vnořené třídy a reflexe při dotazu sestaví pozměněný název podle následujících pravidel.

Plně kvalifikovaný název třídy může vypadat například takto:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Pokud by obor názvů byl TopNamespace.Sub+Namespace, řetězec by musel před znakem plus (+) zadat řídicí znak (\), aby se zabránilo jeho interpretaci jako oddělovače vnoření. Reflexe vygeneruje tento řetězec následujícím způsobem:

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

Výraz "++" se změní na \+\+" a "\" na "\\".

Tento kvalifikovaný název lze zachovat a později použít k načtení Type. Pokud chcete vyhledat a načíst Type, použijte GetType buď jenom s názvem typu, nebo s názvem kvalifikovaného typu sestavení. GetType s názvem typu bude hledat Type pouze v sestavení volajícího a pak v sestavení Systému. GetType s názvem kvalifikovaného typu sestavení vyhledá v libovolném Type sestavení.

Názvy typů mohou obsahovat koncové znaky poskytující další informace o typu, například zda se jedná o typ ukazatele, odkazu nebo pole. Pokud chcete načíst název typu bez těchto koncových znaků, použijte t.GetElementType().ToString(), kde t je typ.

Mezery jsou brány v úvahu ve všech součástech názvu typu s výjimkou názvu sestavení. V názvu sestavení jsou brány v úvahu mezery před oddělovačem ',', zatímco mezery za oddělovačem ',' jsou ignorovány.

Název obecného typu končí zpětným znakem (') následovaným číslicemi představujícími počet argumentů obecného typu. Účelem tohoto manglingu názvů je umožnit kompilátorům podporovat obecné typy se stejným názvem, ale s různými počty parametrů typu, které se vyskytují ve stejném oboru. Reflexe například vrátí zkamenělé názvy Tuple`1 a Tuple`2 z obecných metod Tuple(Of T) a Tuple(Of T0, T1) v jazyce Visual Basic nebo Tuple<T> a Tuple<T0, T1> v jazyce Visual C#.

U obecných typů je seznam argumentů typu uzavřený v závorkách a argumenty typu jsou oddělené čárkami. Například obecný Dictionary<TKey,TValue> má dva parametry typu. Hodnota A Dictionary<TKey,TValue> s MyType klíči typu String může být reprezentována následujícím způsobem:

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

Chcete-li v seznamu argumentů typu určit typ kvalifikovaný pro sestavení, uzavřete typ kvalifikovaný pro sestavení do závorek. Jinak jsou čárky, které oddělují části kvalifikovaného názvu sestavení, interpretovány jako oddělovače dalších argumentů typu. Například Dictionary<TKey,TValue> z MyType MyAssembly.dll s klíči typu Stringmůže být zadán takto:

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

Typy s možnou hodnotou null jsou speciálním případem obecných typů. Například hodnota nullable Int32 je reprezentována řetězcem "System.Nullable'1[System.Int32]".

Následující tabulka ukazuje syntaxi, kterou GetType používáte pro různé typy.

Viz také

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Určení úplných názvů typů

Zdroj:

Type.CoreCLR.cs

Zdroj:

Type.CoreCLR.cs

Zdroj:

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

Parametry

Návraty

Typ se zadaným názvem. Pokud typ není nalezen, parametr určuje, throwOnError zda null je vrácen nebo je vyvolán výjimka. V některých případech dojde k výjimce bez ohledu na hodnotu parametru throwOnError. Viz část Výjimky.

Výjimky

Poznámky

Můžete použít metodu GetType k získání objektu Type pro typ v jiném sestavení, pokud znáte jeho název kvalifikovaný pro sestavení, který lze získat z AssemblyQualifiedName. GetType způsobí načtení sestavení zadaného v typeName. Sestavení můžete také načíst pomocí Assembly.Load metody a pak pomocí Assembly.GetType metody nebo Assembly.GetTypes získat Type objekty. Pokud je typ v sestavení, které váš program v době kompilace zná, je efektivnější ho použít typeof v jazyce C# nebo GetType operátor v jazyce Visual Basic.

GetType funguje pouze u sestavení načtených z disku. Pokud zavoláte GetType k vyhledání typu definovaného v dynamickém sestavení definovaném System.Reflection.Emit pomocí služeb, může dojít k nekonzistentnímu chování. Chování závisí na tom, zda dynamické sestavení je trvalé, tj. vytvořené pomocí RunAndSave režimů přístupu nebo Save výčtu System.Reflection.Emit.AssemblyBuilderAccess . Pokud je dynamické sestavení trvalé a bylo zapsáno na disk před GetType je volána, zavaděč najde uložené sestavení na disku, načte toto sestavení a načte typ z daného sestavení. Pokud sestavení nebylo při volání uloženo na disk GetType , vrátí nullmetoda . GetType nerozumí přechodným dynamickým sestavením; Proto volání GetType pro načtení typu v přechodném dynamickém sestavení vrátí null.

Pokud chcete použít GetType v dynamickém modulu, přihlaste se k odběru AppDomain.AssemblyResolve události a před uložením volejte GetType . V opačném případě získáte dvě kopie sestavení v paměti.

Parametr throwOnError určuje, co se stane, když se typ nenajde, a také potlačí určité další podmínky výjimky, jak je popsáno v části Výjimky. Některé výjimky jsou vyvoláné bez ohledu na hodnotu .throwOnError Pokud je například typ nalezen, ale nelze ho načíst, vyvolá se i v případě, TypeLoadException že throwOnError je false.

Následující tabulka ukazuje, které členy základní třídy jsou vráceny metodami Get při reflexi typu.

1. Skrývání podle názvu a podpisu bere v úvahu všechny části podpisu včetně vlastních modifikátorů, návratových typů, typů parametrů, sentinelů a nespravovaných konvencí volání. Jedná se o binární porovnání.

2. Pro účely reflexe jsou vlastnosti a události skrývány podle názvu a podpisu. Má-li vlastnost v základní třídě přístupové metody get i set, ale odvozená třída má pouze přístupovou metodu get, vlastnost odvozené třídy skryje vlastnost základní třídy a nebudete mít k dispozici přístup k metodě set základní třídy.

3. Vlastní atributy nejsou součástí systému společných typů.

Pole nebo typy modelu COM nejsou vyhledána, pokud již nebyly načteny do tabulky dostupných tříd.

typeName může být název typu kvalifikovaný jeho oborem názvů nebo kvalifikovaný název sestavení, který obsahuje specifikaci názvu sestavení. Viz třída AssemblyQualifiedName.

Pokud typeName obsahuje obor názvů, ale ne název sestavení, tato metoda prohledá pouze sestavení volajícího objektu a mscorlib.dll/System.Private.CoreLib.dll v tomto pořadí. Pokud typeName je plně kvalifikovaný s částečným nebo úplným názvem sestavení, tato metoda hledá v zadaném sestavení. Pokud má sestavení silný název, vyžaduje se úplný název sestavení.

Vlastnost AssemblyQualifiedName vrátí plně kvalifikovaný název typu včetně vnořených typů, názvu sestavení a argumentů typu. Všechny kompilátory, které podporují modul Common Language Runtime, vygenerují jednoduchý název vnořené třídy a reflexe při dotazu sestaví pozměněný název podle následujících pravidel.

Plně kvalifikovaný název třídy může vypadat například takto:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Pokud by obor názvů byl TopNamespace.Sub+Namespace, pak by řetězec musel před znaménkem plus (+) řídicím znakem (\), aby se zabránilo jeho interpretaci jako oddělovače vnoření. Reflexe vygeneruje tento řetězec následujícím způsobem:

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

Z "++" se změní "\+\+" a z "\" se změní na "\\".

Tento kvalifikovaný název lze zachovat a později použít k načtení .Type Pokud chcete vyhledat a načíst Type, použijte GetType buď pouze s názvem typu, nebo s názvem kvalifikovaného typu sestavení. GetType s názvem typu bude hledat Type pouze v sestavení volajícího a poté v sestavení Systému. GetType s názvem kvalifikovaného typu sestavení vyhledá v libovolném Type sestavení.

Názvy typů mohou obsahovat koncové znaky poskytující další informace o typu, například zda se jedná o typ ukazatele, odkazu nebo pole. Pokud chcete načíst název typu bez těchto koncových znaků, použijte t.GetElementType().ToString(), kde t je typ.

Mezery jsou brány v úvahu ve všech součástech názvu typu s výjimkou názvu sestavení. V názvu sestavení jsou brány v úvahu mezery před oddělovačem ',', zatímco mezery za oddělovačem ',' jsou ignorovány.

Název obecného typu končí zpětným znakem (') následovaným číslicemi představujícími počet argumentů obecného typu. Účelem tohoto manglingu názvů je umožnit kompilátorům podporovat obecné typy se stejným názvem, ale s různými počty parametrů typu, které se vyskytují ve stejném oboru. Reflexe například vrátí zkamenělé názvy Tuple`1 a Tuple`2 z obecných metod Tuple(Of T) a Tuple(Of T0, T1) v jazyce Visual Basic nebo Tuple<T> a Tuple<T0, T1> v jazyce Visual C#.

U obecných typů je seznam argumentů typu uzavřený v závorkách a argumenty typu jsou oddělené čárkami. Například obecný Dictionary<TKey,TValue> má dva parametry typu. Hodnota A Dictionary<TKey,TValue> s MyType klíči typu String může být reprezentována následujícím způsobem:

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

Chcete-li v seznamu argumentů typu určit typ kvalifikovaný pro sestavení, uzavřete typ kvalifikovaný pro sestavení do závorek. Jinak jsou čárky, které oddělují části kvalifikovaného názvu sestavení, interpretovány jako oddělovače dalších argumentů typu. Například Dictionary<TKey,TValue> z MyType MyAssembly.dll s klíči typu Stringmůže být zadán takto:

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

Typy s možnou hodnotou null jsou speciálním případem obecných typů. Například hodnota nullable Int32 je reprezentována řetězcem "System.Nullable'1[System.Int32]".

Následující tabulka ukazuje syntaxi, kterou GetType používáte pro různé typy.

Viz také

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Určení úplných názvů typů

Zdroj:

Type.CoreCLR.cs

Zdroj:

Type.CoreCLR.cs

Zdroj:

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

Parametry

Návraty

Typ se zadaným názvem nebo null pokud nebyl nalezen.

Výjimky

Poznámky

Scénáře použití pro tuto metodu a podrobnosti o parametrech assemblyResolver a typeResolver najdete v GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) přetížení metody.

Volání přetížení této metody je stejné jako volání GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) přetížení metody a určení false parametrů throwOnError a ignoreCase .

Zdroj:

Type.CoreCLR.cs

Zdroj:

Type.CoreCLR.cs

Zdroj:

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

Parametry

Návraty

Typ se zadaným názvem. Pokud typ není nalezen, parametr určuje, throwOnError zda null je vrácena nebo je vyvolán výjimka. V některých případech dojde k výjimce bez ohledu na hodnotu .throwOnError Viz část Výjimky.

Výjimky

Poznámky

Scénáře použití pro tuto metodu a podrobnosti o parametrech assemblyResolver a typeResolver najdete v GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) přetížení metody.

Volání tohoto přetížení metody je stejné jako volání GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) přetížení metody a určení false parametru ignoreCase .