Type.GetType Methode

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

Parameter

Gibt zurück

Der Typ mit dem angegebenen Namen. Wenn der Typ nicht gefunden wird, gibt der throwOnError-Parameter an, ob null zurückgegeben oder eine Ausnahme ausgelöst wird. In einigen Fällen wird unabhängig vom Wert von throwOnError eine Ausnahme ausgelöst. Informationen finden Sie im Abschnitt für Ausnahmen.

Ausnahmen

Hinweise

Weitere Informationen zu dieser API finden Sie unter Ergänzende API-Hinweise für Type.GetType.

public:
 Type ^ GetType();

public:
 virtual Type ^ GetType();

public Type GetType ();

override this.GetType : unit -> Type

Public Function GetType () As Type

Gibt zurück

Der aktuelle Type.

Implementiert

Ausnahmen

Weitere Informationen

• TypeLoadException
• Specifying Fully Qualified Type Names (Angeben vollqualifizierter Typnamen)

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

Parameter

Gibt zurück

Der Typ mit dem angegebenen Namen, sofern gefunden, andernfalls null.

Ausnahmen

Beispiele

Im folgenden Beispiel wird der Typ von System.Int32 abgerufen, und dieses Typobjekt wird verwendet, um die FullName -Eigenschaft von System.Int32anzuzeigen.

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

Hinweise

Sie können die GetType -Methode verwenden, um ein Type Objekt für einen Typ in einer anderen Assembly abzurufen, wenn Sie dessen assemblyqualifizierten Namen kennen, der von AssemblyQualifiedNameabgerufen werden kann. GetType verursacht das Laden der in typeNameangegebenen Assembly. Sie können eine Assembly auch mit der Assembly.Load -Methode laden und dann die Assembly.GetType -Methode oder Assembly.GetTypes verwenden, um Objekte abzurufen Type . Wenn sich ein Typ in einer Assembly befindet, die Ihrem Programm zur Kompilierzeit bekannt ist, ist die Verwendung typeof in C# oder dem GetType Operator in Visual Basic effizienter.

GetType funktioniert nur für Assemblys, die von einem Datenträger geladen werden. Wenn Sie aufrufen GetType , um einen Typ zu suchen, der in einer dynamischen Assembly definiert ist, die mithilfe der System.Reflection.Emit Dienste definiert wurde, erhalten Sie möglicherweise inkonsistentes Verhalten. Das Verhalten hängt davon ab, ob die dynamische Assembly persistent ist, d. h. mit dem RunAndSave Zugriffsmodus oder Save der System.Reflection.Emit.AssemblyBuilderAccess -Enumeration erstellt wird. Wenn die dynamische Assembly persistent ist und auf den Datenträger geschrieben wurde, bevor GetType aufgerufen wird, findet das Ladeprogramm die gespeicherte Assembly auf dem Datenträger, lädt diese Assembly und ruft den Typ von dieser Assembly ab. Wenn die Assembly beim GetType Aufruf nicht auf dem Datenträger gespeichert wurde, gibt die -Methode zurück null. GetType versteht keine vorübergehenden dynamischen Assemblys; Daher gibt der Aufruf GetType zum Abrufen eines Typs in einer vorübergehenden dynamischen Assembly zurück null.

Um für ein dynamisches Modul zu verwenden GetType , abonnieren Sie das AppDomain.AssemblyResolve Ereignis, und rufen Sie GetType auf, bevor Sie speichern. Andernfalls erhalten Sie zwei Kopien der Assembly im Arbeitsspeicher.

Die folgende Tabelle zeigt, welche Member einer Basisklasse von den Get Methoden zurückgegeben werden, wenn sie einen Typ reflektieren.

1. Hide-by-name-and-signature berücksichtigt alle Teile der Signatur, einschließlich benutzerdefinierter Modifizierer, Rückgabetypen, Parametertypen, Sentinels und nicht verwalteter Aufrufkonventionen. Dies ist ein binärer Vergleich.

2. Für die Reflektion werden Eigenschaften und Ereignisse nach Name und Signatur ausgeblendet. Wenn Sie über eine Eigenschaft mit einem get- und einem set-Accessor in der Basisklasse verfügen, die abgeleitete Klasse jedoch nur über einen get-Accessor verfügt, blendet die abgeleitete Klasseneigenschaft die Basisklasseneigenschaft aus, und Sie können nicht auf den Setter für die Basisklasse zugreifen.

3. Benutzerdefinierte Attribute sind nicht Teil des allgemeinen Typsystems.

Arrays oder COM-Typen werden nur dann gesucht, wenn sie bereits in die Tabelle der verfügbaren Klassen geladen wurden.

typeName kann der Typname sein, der durch seinen Namespace qualifiziert ist, oder ein assemblyqualifizierter Name, der eine Assemblynamensspezifikation enthält. Siehe AssemblyQualifiedName.

Wenn typeName den Namespace, aber nicht den Assemblynamen enthält, durchsucht diese Methode nur die Assembly des aufrufenden Objekts und mscorlib.dll/System.Private.CoreLib.dll in dieser Reihenfolge. Wenn typeName mit dem vollständigen oder teilweisen Assemblynamen qualifiziert ist, durchsucht diese Methode die angegebene Assembly. Wenn die Assembly einen starken Namen hat, ist ein vollständiger Assemblyname erforderlich.

Die AssemblyQualifiedName Eigenschaft gibt einen vollqualifizierten Typnamen zurück, einschließlich geschachtelter Typen, des Assemblynamens und generischer Typargumente. Alle Compiler, die die Common Language Runtime unterstützen, geben den einfachen Namen einer geschachtelten Klasse aus, und die Reflektion erstellt einen abgefragten Namen gemäß den folgenden Konventionen.

Der vollqualifizierte Name für eine Klasse könnte beispielsweise wie folgt aussehen:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Wenn der Namespace TopNamespace.Sub+Namespace wäre, müsste die Zeichenfolge dem Pluszeichen (+) ein Escapezeichen (\) vorangestellt werden, um zu verhindern, dass es als Schachtelungstrennzeichen interpretiert wird. Die Reflektion gibt diese Zeichenfolge wie folgt aus:

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

Ein "++" wird zu "\+\+", und ein "\" zu "\\".

Dieser qualifizierte Name kann beibehalten und später zum Laden von Typeverwendet werden. Um nach zu suchen und zu laden, Typeverwenden Sie GetType entweder nur mit dem Typnamen oder mit dem assemblyqualifizierten Typnamen. GetType nur mit dem Typnamen wird in der Assembly des Aufrufers und dann in der Systemassembly nach Type dem gesucht. GetType mit dem qualifizierten Typnamen der Assembly sucht nach dem Type in jeder Assembly.

Typnamen können nachfolgende Zeichen enthalten, die zusätzliche Informationen zum Typ angeben, z. B. ob der Typ ein Verweistyp, ein Zeigertyp oder ein Arraytyp ist. Um den Typnamen ohne diese nachfolgenden Zeichen abzurufen, verwenden Sie t.GetElementType().ToString(), wobei t der Typ ist.

Leerzeichen sind in allen Typnamenskomponenten mit Ausnahme des Assemblynamens relevant. Im Assemblynamen sind Leerzeichen vor dem Trennzeichen "," relevant, aber Leerzeichen nach dem Trennzeichen "," werden ignoriert.

Der Name eines generischen Typs endet mit einem Backtick (') gefolgt von Ziffern, die die Anzahl generischer Typargumente darstellen. Der Zweck dieses Namensmanglings besteht darin, Compilern die Unterstützung generischer Typen mit demselben Namen, aber mit unterschiedlicher Anzahl von Typparametern zu ermöglichen, die im gleichen Bereich auftreten. Die Reflektion gibt beispielsweise die verwalteten Namen Tuple`1 und Tuple`2 aus den generischen Methoden Tuple(Of T) und Tuple(Of T0, T1) in Visual Basic oder Tuple<T> und Tuple<T0, T1> in Visual C# zurück.

Bei generischen Typen wird die Typargumentliste in Klammern eingeschlossen, und die Typargumente werden durch Kommas getrennt. Ein generischer Dictionary<TKey,TValue> Typ verfügt beispielsweise über zwei Typparameter. Ein Dictionary<TKey,TValue> mit MyType Schlüsseln vom Typ String kann wie folgt dargestellt werden:

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

Um einen assemblyqualifizierten Typ in einer Typargumentliste anzugeben, schließen Sie den assemblyqualifizierten Typ in Klammern ein. Andernfalls werden die Kommas, die die Teile des assemblyqualifizierten Namens trennen, als Trennzeichen für zusätzliche Typargumente interpretiert. Beispielsweise kann ein Dictionary<TKey,TValue> fromMyAssembly.dll MyType mit Schlüsseln vom Typ Stringwie folgt angegeben werden:

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

Typen, die Nullwerte zulassen, sind ein Sonderfall generischer Typen. Ein Nullable-Wert Int32 wird beispielsweise durch die Zeichenfolge "System.Nullable'1[System.Int32]" dargestellt.

Die folgende Tabelle zeigt die Syntax, die Sie für GetType verschiedene Typen verwenden.

Weitere Informationen

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Specifying Fully Qualified Type Names (Angeben vollqualifizierter Typnamen)

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

Parameter

Gibt zurück

Der Typ mit dem angegebenen Namen. Wenn der Typ nicht gefunden wird, gibt der throwOnError-Parameter an, ob null zurückgegeben oder eine Ausnahme ausgelöst wird. In einigen Fällen wird unabhängig vom Wert von throwOnError eine Ausnahme ausgelöst. Informationen finden Sie im Abschnitt für Ausnahmen.

Ausnahmen

Beispiele

Das folgende Beispiel ruft den Typ von System.Int32 ab und verwendet dieses Typobjekt, um die FullName -Eigenschaft von System.Int32anzuzeigen. Wenn ein Typobjekt auf eine Assembly verweist, die nicht vorhanden ist, löst dieses Beispiel eine Ausnahme aus.

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

Hinweise

Sie können die GetType -Methode verwenden, um ein Type Objekt für einen Typ in einer anderen Assembly abzurufen, wenn Sie dessen assemblyqualifizierten Namen kennen, der von AssemblyQualifiedNameabgerufen werden kann. GetType verursacht das Laden der assembly, die in typeNameangegeben ist. Sie können auch eine Assembly mit der Assembly.Load -Methode laden und dann die Assembly.GetType -Methode oder Assembly.GetTypes verwenden, um Objekte abzurufen Type . Wenn sich ein Typ in einer Assembly befindet, die Ihrem Programm zur Kompilierzeit bekannt ist, ist die Verwendung typeof in C# oder dem GetType Operator in Visual Basic effizienter.

GetType Funktioniert nur für Assemblys, die vom Datenträger geladen werden. Wenn Sie aufrufen GetType , um einen Typ zu suchen, der in einer dynamischen Assembly definiert ist, die mithilfe der System.Reflection.Emit Dienste definiert ist, erhalten Sie möglicherweise ein inkonsistentes Verhalten. Das Verhalten hängt davon ab, ob die dynamische Assembly persistent ist, d. h. mit den RunAndSave Zugriffsmodi oder Save der System.Reflection.Emit.AssemblyBuilderAccess Enumeration erstellt wird. Wenn die dynamische Assembly persistent ist und auf den Datenträger geschrieben wurde, bevor GetType aufgerufen wird, findet das Ladeprogramm die gespeicherte Assembly auf dem Datenträger, lädt diese Assembly und ruft den Typ von dieser Assembly ab. Wenn die Assembly beim GetType Aufrufen nicht auf dem Datenträger gespeichert wurde, gibt die -Methode zurück null. GetType versteht keine vorübergehenden dynamischen Assemblys; Daher wird beim Aufrufen GetType zum Abrufen eines Typs in einer vorübergehenden dynamischen Assembly zurückgegeben null.

Um in einem dynamischen Modul zu verwenden GetType , abonnieren Sie das AppDomain.AssemblyResolve Ereignis, und rufen Sie vor dem Speichern auf GetType . Andernfalls erhalten Sie zwei Kopien der Assembly im Arbeitsspeicher.

Der throwOnError Parameter gibt an, was geschieht, wenn der Typ nicht gefunden wird, und unterdrückt auch bestimmte andere Ausnahmebedingungen, wie im Abschnitt Ausnahmen beschrieben. Einige Ausnahmen werden unabhängig vom Wert von throwOnErrorausgelöst. Wenn der Typ beispielsweise gefunden, aber nicht geladen werden kann, wird ein TypeLoadException ausgelöst, auch wenn throwOnErrorfalseist.

Die folgende Tabelle zeigt, welche Member einer Basisklasse von den Get Methoden zurückgegeben werden, wenn sie einen Typ reflektieren.

1. Hide-by-Name-and-signature berücksichtigt alle Teile der Signatur, einschließlich benutzerdefinierter Modifizierer, Rückgabetypen, Parametertypen, Sentinels und nicht verwalteter Aufrufkonventionen. Dies ist ein binärer Vergleich.

2. Für die Reflektion werden Eigenschaften und Ereignisse nach Name und Signatur ausgeblendet. Wenn Sie über eine Eigenschaft mit einem get- und einem Set-Accessor in der Basisklasse verfügen, die abgeleitete Klasse jedoch nur über einen Get-Accessor verfügt, blendet die abgeleitete Klasseneigenschaft die Basisklasseeigenschaft aus, und Sie können nicht auf den Setter für die Basisklasse zugreifen.

3. Benutzerdefinierte Attribute sind nicht Teil des allgemeinen Typsystems.

Arrays oder COM-Typen werden nicht gesucht, es sei denn, sie wurden bereits in die Tabelle der verfügbaren Klassen geladen.

typeName kann der Typname sein, der durch seinen Namespace qualifiziert ist, oder ein assemblyqualifizierter Name, der eine Assemblynamenspezifikation enthält. Siehe AssemblyQualifiedName.

Wenn typeName der Namespace, aber nicht der Assemblyname enthalten ist, durchsucht diese Methode nur die Assembly des aufrufenden Objekts und mscorlib.dll/System.Private.CoreLib.dll in dieser Reihenfolge. Wenn typeName mit dem namen der partiellen oder vollständigen Assembly voll qualifiziert ist, durchsucht diese Methode die angegebene Assembly. Wenn die Assembly einen starken Namen hat, ist ein vollständiger Assemblyname erforderlich.

Die AssemblyQualifiedName Eigenschaft gibt einen vollqualifizierten Typnamen zurück, einschließlich geschachtelter Typen, des Assemblynamens und generischer Argumente. Alle Compiler, die die Common Language Runtime unterstützen, geben den einfachen Namen einer geschachtelten Klasse aus, und Reflektion erstellt einen abgefragten Namen gemäß den folgenden Konventionen.

Der vollqualifizierte Name für eine Klasse könnte beispielsweise wie folgt aussehen:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Wenn der Namespace TopNamespace.Sub+Namespace ist, müsste die Zeichenfolge dem Pluszeichen (+) ein Escapezeichen (\) vorangestellt werden, um zu verhindern, dass es als Schachtelungstrennzeichen interpretiert wird. Reflektion gibt diese Zeichenfolge wie folgt aus:

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

Ein "++" wird zu "\+\+" und aus "\" zu "\\".

Dieser qualifizierte Name kann beibehalten und später zum Laden von Typeverwendet werden. Um nach zu suchen und zu Typeladen, verwenden Sie GetType entweder nur mit dem Typnamen oder mit dem Namen des qualifizierten Assemblytyps. GetType mit dem Typnamen wird nur nach dem Type in der Assembly des Aufrufers und dann in der Systemassembly gesucht. GetType mit dem assemblyqualifizierten Typnamen sucht nach dem Type in jeder Assembly.

Typnamen können nachfolgende Zeichen enthalten, die zusätzliche Informationen zum Typ angeben, z. B. ob es sich bei dem Typ um einen Verweistyp, einen Zeigertyp oder einen Arraytyp handelt. Um den Typnamen ohne diese nachfolgenden Zeichen abzurufen, verwenden Sie t.GetElementType().ToString(), wobei t der Typ ist.

Leerzeichen sind in allen Typnamenkomponenten mit Ausnahme des Assemblynamens relevant. Im Assemblynamen sind Leerzeichen vor dem Trennzeichen ",", aber Leerzeichen nach dem Trennzeichen "," werden ignoriert.

Der Name eines generischen Typs endet mit einem Backtick (') gefolgt von Ziffern, die die Anzahl der generischen Typargumente darstellen. Der Zweck dieses Namens-Mangling besteht darin, Compilern zu ermöglichen, generische Typen mit dem gleichen Namen, aber mit unterschiedlicher Anzahl von Typparametern zu unterstützen, die im gleichen Bereich auftreten. Reflektion gibt beispielsweise die verwalteten Namen Tuple`1 und Tuple`2 von den generischen Methoden Tuple(Of T) und Tuple(Of T0, T1) in Visual Basic oder Tuple<T> und Tuple<T0, T1> in Visual C# zurück.

Bei generischen Typen wird die Typargumentliste in Klammern eingeschlossen, und die Typargumente werden durch Kommas getrennt. Ein generisches Dictionary<TKey,TValue> Beispiel verfügt über zwei Typparameter. Eine Dictionary<TKey,TValue> von MyType mit Schlüsseln vom Typ String kann wie folgt dargestellt werden:

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

Um einen assemblyqualifizierten Typ in einer Typargumentliste anzugeben, schließen Sie den assemblyqualifizierten Typ in Klammern ein. Andernfalls werden die Kommas, die die Teile des assemblyqualifizierten Namens trennen, als Trennzeichen für zusätzliche Typargumente interpretiert. Beispielsweise kann ein Dictionary<TKey,TValue> von MyType von MyAssembly.dll mit Schlüsseln vom Typ Stringwie folgt angegeben werden:

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

Nullable-Typen sind ein Sonderfall generischer Typen. Ein NULLable-Wert Int32 wird beispielsweise durch die Zeichenfolge "System.Nullable'1[System.Int32]" dargestellt.

Die folgende Tabelle zeigt die Syntax, die Sie für GetType verschiedene Typen verwenden.

Weitere Informationen

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Specifying Fully Qualified Type Names (Angeben vollqualifizierter Typnamen)

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

Parameter

Gibt zurück

Der Typ mit dem angegebenen Namen. Wenn der Typ nicht gefunden wird, gibt der throwOnError-Parameter an, ob null zurückgegeben oder eine Ausnahme ausgelöst wird. In einigen Fällen wird unabhängig vom Wert von throwOnError eine Ausnahme ausgelöst. Informationen finden Sie im Abschnitt für Ausnahmen.

Ausnahmen

Hinweise

Sie können die GetType -Methode verwenden, um ein Type Objekt für einen Typ in einer anderen Assembly abzurufen, wenn Sie dessen assemblyqualifizierten Namen kennen, der von AssemblyQualifiedNameabgerufen werden kann. GetType verursacht das Laden der assembly, die in typeNameangegeben ist. Sie können auch eine Assembly mit der Assembly.Load -Methode laden und dann die Assembly.GetType -Methode oder Assembly.GetTypes verwenden, um Objekte abzurufen Type . Wenn sich ein Typ in einer Assembly befindet, die Ihrem Programm zur Kompilierzeit bekannt ist, ist die Verwendung typeof in C# oder dem GetType Operator in Visual Basic effizienter.

GetType Funktioniert nur für Assemblys, die vom Datenträger geladen werden. Wenn Sie aufrufen GetType , um einen Typ zu suchen, der in einer dynamischen Assembly definiert ist, die mithilfe der System.Reflection.Emit Dienste definiert ist, erhalten Sie möglicherweise ein inkonsistentes Verhalten. Das Verhalten hängt davon ab, ob die dynamische Assembly persistent ist, d. h. mit den RunAndSave Zugriffsmodi oder Save der System.Reflection.Emit.AssemblyBuilderAccess Enumeration erstellt wird. Wenn die dynamische Assembly persistent ist und auf den Datenträger geschrieben wurde, bevor GetType aufgerufen wird, findet das Ladeprogramm die gespeicherte Assembly auf dem Datenträger, lädt diese Assembly und ruft den Typ von dieser Assembly ab. Wenn die Assembly beim GetType Aufrufen nicht auf dem Datenträger gespeichert wurde, gibt die -Methode zurück null. GetType versteht keine vorübergehenden dynamischen Assemblys; Daher wird beim Aufrufen GetType zum Abrufen eines Typs in einer vorübergehenden dynamischen Assembly zurückgegeben null.

Um in einem dynamischen Modul zu verwenden GetType , abonnieren Sie das AppDomain.AssemblyResolve Ereignis, und rufen Sie vor dem Speichern auf GetType . Andernfalls erhalten Sie zwei Kopien der Assembly im Arbeitsspeicher.

Der throwOnError Parameter gibt an, was geschieht, wenn der Typ nicht gefunden wird, und unterdrückt auch bestimmte andere Ausnahmebedingungen, wie im Abschnitt Ausnahmen beschrieben. Einige Ausnahmen werden unabhängig vom Wert von throwOnErrorausgelöst. Wenn der Typ beispielsweise gefunden, aber nicht geladen werden kann, wird ein TypeLoadException ausgelöst, auch wenn throwOnErrorfalseist.

Die folgende Tabelle zeigt, welche Member einer Basisklasse von den Get Methoden zurückgegeben werden, wenn sie einen Typ reflektieren.

1. Hide-by-Name-and-signature berücksichtigt alle Teile der Signatur, einschließlich benutzerdefinierter Modifizierer, Rückgabetypen, Parametertypen, Sentinels und nicht verwalteter Aufrufkonventionen. Dies ist ein binärer Vergleich.

2. Für die Reflektion werden Eigenschaften und Ereignisse nach Name und Signatur ausgeblendet. Wenn Sie über eine Eigenschaft mit einem get- und einem Set-Accessor in der Basisklasse verfügen, die abgeleitete Klasse jedoch nur über einen Get-Accessor verfügt, blendet die abgeleitete Klasseneigenschaft die Basisklasseeigenschaft aus, und Sie können nicht auf den Setter für die Basisklasse zugreifen.

3. Benutzerdefinierte Attribute sind nicht Teil des allgemeinen Typsystems.

Arrays oder COM-Typen werden nicht gesucht, es sei denn, sie wurden bereits in die Tabelle der verfügbaren Klassen geladen.

typeName kann der Typname sein, der durch seinen Namespace qualifiziert ist, oder ein assemblyqualifizierter Name, der eine Assemblynamenspezifikation enthält. Siehe AssemblyQualifiedName.

Wenn typeName der Namespace, aber nicht der Assemblyname enthalten ist, durchsucht diese Methode nur die Assembly des aufrufenden Objekts und mscorlib.dll/System.Private.CoreLib.dll in dieser Reihenfolge. Wenn typeName mit dem namen der partiellen oder vollständigen Assembly voll qualifiziert ist, durchsucht diese Methode die angegebene Assembly. Wenn die Assembly einen starken Namen hat, ist ein vollständiger Assemblyname erforderlich.

Die AssemblyQualifiedName Eigenschaft gibt einen vollqualifizierten Typnamen zurück, einschließlich geschachtelter Typen, des Assemblynamens und der Typargumente. Alle Compiler, die die Common Language Runtime unterstützen, geben den einfachen Namen einer geschachtelten Klasse aus, und Reflektion erstellt einen abgefragten Namen gemäß den folgenden Konventionen.

Der vollqualifizierte Name für eine Klasse könnte beispielsweise wie folgt aussehen:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Wenn der Namespace TopNamespace.Sub+Namespace ist, müsste die Zeichenfolge dem Pluszeichen (+) ein Escapezeichen (\) vorangestellt werden, um zu verhindern, dass es als Schachtelungstrennzeichen interpretiert wird. Reflektion gibt diese Zeichenfolge wie folgt aus:

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

Ein "++" wird zu "\+\+" und aus "\" zu "\\".

Dieser qualifizierte Name kann beibehalten und später zum Laden von Typeverwendet werden. Um nach zu suchen und zu Typeladen, verwenden Sie GetType entweder nur mit dem Typnamen oder mit dem Namen des qualifizierten Assemblytyps. GetType mit dem Typnamen wird nur nach dem Type in der Assembly des Aufrufers und dann in der Systemassembly gesucht. GetType mit dem assemblyqualifizierten Typnamen sucht nach dem Type in jeder Assembly.

Typnamen können nachfolgende Zeichen enthalten, die zusätzliche Informationen zum Typ angeben, z. B. ob es sich bei dem Typ um einen Verweistyp, einen Zeigertyp oder einen Arraytyp handelt. Um den Typnamen ohne diese nachfolgenden Zeichen abzurufen, verwenden Sie t.GetElementType().ToString(), wobei t der Typ ist.

Leerzeichen sind in allen Typnamenkomponenten mit Ausnahme des Assemblynamens relevant. Im Assemblynamen sind Leerzeichen vor dem Trennzeichen ",", aber Leerzeichen nach dem Trennzeichen "," werden ignoriert.

Der Name eines generischen Typs endet mit einem Backtick (') gefolgt von Ziffern, die die Anzahl der generischen Typargumente darstellen. Der Zweck dieses Namens-Mangling besteht darin, Compilern zu ermöglichen, generische Typen mit dem gleichen Namen, aber mit unterschiedlicher Anzahl von Typparametern zu unterstützen, die im gleichen Bereich auftreten. Reflektion gibt beispielsweise die verwalteten Namen Tuple`1 und Tuple`2 von den generischen Methoden Tuple(Of T) und Tuple(Of T0, T1) in Visual Basic oder Tuple<T> und Tuple<T0, T1> in Visual C# zurück.

Bei generischen Typen wird die Typargumentliste in Klammern eingeschlossen, und die Typargumente werden durch Kommas getrennt. Ein generisches Dictionary<TKey,TValue> Beispiel verfügt über zwei Typparameter. Eine Dictionary<TKey,TValue> von MyType mit Schlüsseln vom Typ String kann wie folgt dargestellt werden:

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

Um einen assemblyqualifizierten Typ in einer Typargumentliste anzugeben, schließen Sie den assemblyqualifizierten Typ in Klammern ein. Andernfalls werden die Kommas, die die Teile des assemblyqualifizierten Namens trennen, als Trennzeichen für zusätzliche Typargumente interpretiert. Beispielsweise kann ein Dictionary<TKey,TValue> von MyType von MyAssembly.dll mit Schlüsseln vom Typ Stringwie folgt angegeben werden:

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

Nullable-Typen sind ein Sonderfall generischer Typen. Ein NULLable-Wert Int32 wird beispielsweise durch die Zeichenfolge "System.Nullable'1[System.Int32]" dargestellt.

Die folgende Tabelle zeigt die Syntax, die Sie für GetType verschiedene Typen verwenden.

Weitere Informationen

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Specifying Fully Qualified Type Names (Angeben vollqualifizierter Typnamen)

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

Parameter

Gibt zurück

Der Typ mit dem angegebenen Namen oder null, wenn der Typ nicht gefunden wird.

Ausnahmen

Hinweise

Verwendungsszenarien für diese Methode und Details zu den assemblyResolver Parametern und typeResolver finden Sie in der GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) Methodenüberladung.

Das Aufrufen dieser Methodenüberladung ist mit dem Aufrufen der GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) Methodenüberladung und dem Angeben false für die throwOnError Parameter und ignoreCase identisch.

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

Parameter

Gibt zurück

Der Typ mit dem angegebenen Namen. Wenn der Typ nicht gefunden wird, gibt der throwOnError-Parameter an, ob null zurückgegeben oder eine Ausnahme ausgelöst wird. In einigen Fällen wird unabhängig vom Wert von throwOnError eine Ausnahme ausgelöst. Informationen finden Sie im Abschnitt für Ausnahmen.

Ausnahmen

Hinweise

Verwendungsszenarien für diese Methode und Details zu den assemblyResolver Parametern und typeResolver finden Sie in der GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) Methodenüberladung.

Das Aufrufen dieser Methodenüberladung entspricht dem Aufrufen der GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) Methodenüberladung und dem Angeben false für den ignoreCase -Parameter.