Type.GetType 方法

Source:

Type.CoreCLR.cs

Source:

Type.CoreCLR.cs

Source:

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

参数

返回

具有指定名称的类型。 如果找不到该类型，则 throwOnError 参数指定是返回 null 还是引发异常。 在某些情况下，将引发异常，而不考虑 throwOnError 的值。 请参见“异常”部分。

例外

注解

有关此 API 的详细信息，请参阅 Type.GetType 的补充 API 说明。

Source:

Type.cs

Source:

Type.cs

Source:

Type.cs

public:
 Type ^ GetType();

public:
 virtual Type ^ GetType();

public Type GetType ();

override this.GetType : unit -> Type

Public Function GetType () As Type

返回

当前的 Type。

实现

例外

另请参阅

• TypeLoadException
• 指定完全限定的类型名称

Source:

Type.CoreCLR.cs

Source:

Type.CoreCLR.cs

Source:

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

参数

返回

具有指定名称的类型（如果找到的话）；否则为 null。

例外

示例

以下示例检索 的类型 System.Int32 ，并使用该类型对象显示 FullName 的 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

注解

如果知道另一个Type程序集中的某个类型的对象，则可以使用 GetType 方法获取其程序集限定名称（可从 获取AssemblyQualifiedName）。 GetType 导致加载 中指定的 typeName程序集。 还可以使用 Assembly.Load 方法加载程序集，然后使用 Assembly.GetType 或 Assembly.GetTypes 方法获取 Type 对象。 如果在编译时程序已知的程序集中某个类型，则使用 C# 或 GetType Visual Basic 中的 运算符会更有效typeof。

GetType 仅适用于从磁盘加载的程序集。 如果调用 GetType 以查找在使用 System.Reflection.Emit 服务定义的动态程序集中定义的类型，则可能会出现不一致的行为。 该行为取决于动态程序集是否是永久性的，即使用 RunAndSave 枚举的 System.Reflection.Emit.AssemblyBuilderAccess 或 Save 访问模式创建的。 如果动态程序集是永久性的，并且已在调用 之前 GetType 写入磁盘，则加载程序将在磁盘上查找保存的程序集，加载该程序集，并从该程序集检索类型。 如果在调用 时 GetType 程序集尚未保存到磁盘，则 方法返回 null。 GetType 不了解暂时性动态程序集;因此，调用 GetType 以检索暂时性动态程序集中的类型将 null返回 。

若要在动态模块上使用 GetType ，请订阅 事件并在 AppDomain.AssemblyResolve 保存之前调用 GetType 。 否则，将在内存中获取程序集的两个副本。

下表显示了在对类型进行反射时方法返回 Get 的基类成员。

1. 按名称和签名隐藏考虑签名的所有部分，包括自定义修饰符、返回类型、参数类型、sentinels 和非托管调用约定。 这是二进制比较。

2. 对于反射，属性和事件按名称和签名隐藏。 如果在基类中具有同时具有 get 和 set 访问器的属性，但派生类只有 get 访问器，则派生类属性将隐藏基类属性，并且您将无法访问基类上的 setter。

3. 自定义属性不是通用类型系统的一部分。

除非数组或 COM 类型已加载到可用类的表中，否则不会搜索它们。

typeName 可以是由其命名空间限定的类型名称，也可以是包含程序集名称规范的程序集限定名称。 请参阅 AssemblyQualifiedName。

如果 typeName 包括命名空间，但不包括程序集名称，则此方法仅搜索调用对象的程序集，并按该顺序 mscorlib.dll/System.Private.CoreLib.dll。 如果 typeName 使用部分或完整程序集名称完全限定，则此方法在指定的程序集中搜索。 如果程序集具有强名称，则需要完整的程序集名称。

属性 AssemblyQualifiedName 返回一个完全限定的类型名称，包括嵌套类型、程序集名称和泛型类型参数。 支持公共语言运行时的所有编译器都将发出嵌套类的简单名称，并且反射在查询时会根据以下约定构造一个错误名称。

例如，类的完全限定名称可能如下所示：

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

如果命名空间为 TopNamespace.Sub+Namespace，则字符串必须在加号 (+) 前面加上转义字符 (\) ，以防止将其解释为嵌套分隔符。 反射发出此字符串，如下所示：

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

“++”变为“\+\+”，“\”变为“\\”。

此限定名称可以持久保存，稍后用于加载 Type。 若要搜索和加载 Type，请 GetType 仅将 与类型名称一起使用，或与程序集限定的类型名称一起使用。 GetType 具有类型名称的 将在调用方程序集中查找 Type ，然后在系统程序集中查找 。 GetType 具有程序集限定的类型名称将在任何程序集中查找 Type 。

类型名称可能包含表示有关类型的其他信息的尾随字符，例如类型是引用类型、指针类型还是数组类型。 若要检索不包含这些尾随字符的类型名称，请使用 t.GetElementType().ToString()，其中 t 是 类型。

空格与除程序集名称以外的所有类型名称组件相关。 在程序集名称中，“，”分隔符前的空格是相关的，但“，”分隔符后面的空格将被忽略。

泛型类型的名称以反引号结尾， (') 后跟表示泛型类型参数数的数字。 此名称整型的目的是允许编译器支持同名但类型参数数量不同（发生在同一范围内）的泛型类型。 例如，反射在 Visual Basic 中或 Visual C# 中返回泛型方法Tuple(Of T)中的 和 中经过整型的名称 Tuple`2Tuple`1 和 Tuple<T0, T1>Tuple(Of T0, T1) 。Tuple<T>

对于泛型类型，类型参数列表用方括号括起来，类型参数用逗号分隔。 例如，泛型 Dictionary<TKey,TValue> 有两个类型参数。 Dictionary<TKey,TValue>MyType具有 类型的String键的 的 可能表示如下：

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

若要在类型参数列表中指定程序集限定的类型，请将程序集限定类型括在方括号内。 否则，分隔程序集限定名称各部分的逗号将被解释为分隔其他类型参数。 例如， Dictionary<TKey,TValue>MyType fromMyAssembly.dll 的 ，其键类型 String为 ，可按如下方式指定：

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

可以为 null 的类型是泛型类型的一种特例。 例如，可为 null 的 Int32 由字符串“System.Nullable'1[System.Int32]”表示。

下表显示了用于各种类型的语法 GetType 。

另请参阅

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• 指定完全限定的类型名称

Source:

Type.CoreCLR.cs

Source:

Type.CoreCLR.cs

Source:

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

参数

返回

具有指定名称的类型。 如果找不到该类型，则 throwOnError 参数指定是返回 null 还是引发异常。 在某些情况下，将引发异常，而不考虑 throwOnError 的值。 请参见“异常”部分。

例外

示例

以下示例检索 的类型 System.Int32 ，并使用该类型对象显示 FullName 的 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

注解

如果知道另一个Type程序集中的类型具有程序集限定的名称（可从 获取），则可以使用 GetType 方法获取AssemblyQualifiedName该类型的对象。 GetType 导致加载 中指定的 typeName程序集。 还可以使用 Assembly.Load 方法加载程序集，然后使用 Assembly.GetType 或 Assembly.GetTypes 方法获取 Type 对象。 如果类型在编译时位于程序已知的程序集中，则使用 C# 或 GetType Visual Basic 中的 运算符会更有效typeof。

GetType 仅适用于从磁盘加载的程序集。 如果调用 GetType 以查找在使用 System.Reflection.Emit 服务定义的动态程序集中定义的类型，可能会出现不一致的行为。 该行为取决于动态程序集是否是永久性的，即使用 RunAndSave 枚举的 System.Reflection.Emit.AssemblyBuilderAccess 或 Save 访问模式创建的。 如果动态程序集是永久性的，并且已在调用 之前 GetType 写入磁盘，则加载程序将在磁盘上查找保存的程序集，加载该程序集，并从该程序集检索类型。 如果在调用 时 GetType 程序集尚未保存到磁盘，则该方法返回 null。 GetType 不了解暂时性动态程序集;因此，调用 GetType 以检索暂时性动态程序集中的类型将 null返回 。

若要在动态模块上使用 GetType ，请订阅 事件并在 AppDomain.AssemblyResolve 保存之前调用 GetType 。 否则，将在内存中获取程序集的两个副本。

参数 throwOnError 指定找不到类型时会发生什么情况，还禁止某些其他异常条件，如异常部分中所述。 无论 的值 throwOnError如何，都会引发一些异常。 例如，如果找到类型但无法加载， TypeLoadException 则即使 throwOnError 为 false，也会引发 。

下表显示了在对类型进行反射时方法返回 Get 的基类成员。

1. 按名称和签名隐藏考虑签名的所有部分，包括自定义修饰符、返回类型、参数类型、sentinels 和非托管调用约定。 这是二进制比较。

2. 对于反射，属性和事件按名称和签名隐藏。 如果在基类中具有同时具有 get 和 set 访问器的属性，但派生类只有 get 访问器，则派生类属性将隐藏基类属性，并且您将无法访问基类上的 setter。

3. 自定义属性不是通用类型系统的一部分。

除非数组或 COM 类型已加载到可用类的表中，否则不会搜索它们。

typeName 可以是由其命名空间限定的类型名称，也可以是包含程序集名称规范的程序集限定名称。 请参阅 AssemblyQualifiedName。

如果 typeName 包括命名空间，但不包括程序集名称，则此方法仅搜索调用对象的程序集，并按该顺序 mscorlib.dll/System.Private.CoreLib.dll。 如果 typeName 使用部分或完整程序集名称完全限定，则此方法在指定的程序集中搜索。 如果程序集具有强名称，则需要完整的程序集名称。

属性 AssemblyQualifiedName 返回一个完全限定的类型名称，包括嵌套类型、程序集名称和泛型参数。 支持公共语言运行时的所有编译器都将发出嵌套类的简单名称，并且反射在查询时会根据以下约定构造一个错误名称。

例如，类的完全限定名称可能如下所示：

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

如果命名空间为 TopNamespace.Sub+Namespace，则字符串必须在加号 (+) 前面加上转义字符 (\) ，以防止将其解释为嵌套分隔符。 反射发出此字符串，如下所示：

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

“++”变为“\+\+”，“\”变为“\\”。

此限定名称可以持久保存，稍后用于加载 Type。 若要搜索和加载 Type，请 GetType 仅将 与类型名称一起使用，或与程序集限定的类型名称一起使用。 GetType 具有类型名称的 将在调用方程序集中查找 Type ，然后在系统程序集中查找 。 GetType 具有程序集限定的类型名称将在任何程序集中查找 Type 。

类型名称可能包含表示有关类型的其他信息的尾随字符，例如类型是引用类型、指针类型还是数组类型。 若要检索不包含这些尾随字符的类型名称，请使用 t.GetElementType().ToString()，其中 t 是 类型。

空格与除程序集名称以外的所有类型名称组件相关。 在程序集名称中，“，”分隔符前的空格是相关的，但“，”分隔符后面的空格将被忽略。

泛型类型的名称以反引号结尾， (') 后跟表示泛型类型参数数的数字。 此名称整型的目的是允许编译器支持同名但类型参数数量不同（发生在同一范围内）的泛型类型。 例如，反射在 Visual Basic 中或 Visual C# 中返回泛型方法Tuple(Of T)中的 和 中经过整型的名称 Tuple`2Tuple`1 和 Tuple<T0, T1>Tuple(Of T0, T1) 。Tuple<T>

对于泛型类型，类型参数列表用方括号括起来，类型参数用逗号分隔。 例如，泛型 Dictionary<TKey,TValue> 有两个类型参数。 Dictionary<TKey,TValue>MyType具有 类型的String键的 的 可能表示如下：

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

若要在类型参数列表中指定程序集限定的类型，请将程序集限定类型括在方括号内。 否则，分隔程序集限定名称各部分的逗号将被解释为分隔其他类型参数。 例如，Dictionary<TKey,TValue>MyType可以按如下所示指定来自 MyAssembly.dll 的 ，其键类型String为 ：

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

可以为 null 的类型是泛型类型的一种特例。 例如，可为 null 的 Int32 由字符串“System.Nullable'1[System.Int32]”表示。

下表显示了用于各种类型的语法 GetType 。

另请参阅

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• 指定完全限定的类型名称

Source:

Type.CoreCLR.cs

Source:

Type.CoreCLR.cs

Source:

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

参数

返回

具有指定名称的类型。 如果找不到该类型，则 throwOnError 参数指定是返回 null 还是引发异常。 在某些情况下，将引发异常，而不考虑 throwOnError 的值。 请参见“异常”部分。

例外

注解

如果知道另一个Type程序集中的类型具有程序集限定的名称（可从 获取），则可以使用 GetType 方法获取AssemblyQualifiedName该类型的对象。 GetType 导致加载 中指定的 typeName程序集。 还可以使用 Assembly.Load 方法加载程序集，然后使用 Assembly.GetType 或 Assembly.GetTypes 方法获取 Type 对象。 如果类型在编译时位于程序已知的程序集中，则使用 C# 或 GetType Visual Basic 中的 运算符会更有效typeof。

GetType 仅适用于从磁盘加载的程序集。 如果调用 GetType 以查找在使用 System.Reflection.Emit 服务定义的动态程序集中定义的类型，可能会出现不一致的行为。 该行为取决于动态程序集是否是永久性的，即使用 RunAndSave 枚举的 System.Reflection.Emit.AssemblyBuilderAccess 或 Save 访问模式创建的。 如果动态程序集是永久性的，并且已在调用 之前 GetType 写入磁盘，则加载程序将在磁盘上查找保存的程序集，加载该程序集，并从该程序集检索类型。 如果在调用 时 GetType 程序集尚未保存到磁盘，则该方法返回 null。 GetType 不了解暂时性动态程序集;因此，调用 GetType 以检索暂时性动态程序集中的类型将 null返回 。

若要在动态模块上使用 GetType ，请订阅 事件并在 AppDomain.AssemblyResolve 保存之前调用 GetType 。 否则，将在内存中获取程序集的两个副本。

参数 throwOnError 指定找不到类型时会发生什么情况，还禁止某些其他异常条件，如异常部分中所述。 无论 的值 throwOnError如何，都会引发一些异常。 例如，如果找到类型但无法加载， TypeLoadException 则即使 throwOnError 为 false，也会引发 。

下表显示了在对类型进行反射时方法返回 Get 的基类成员。

1. 按名称和签名隐藏考虑签名的所有部分，包括自定义修饰符、返回类型、参数类型、sentinels 和非托管调用约定。 这是二进制比较。

2. 对于反射，属性和事件按名称和签名隐藏。 如果在基类中具有同时具有 get 和 set 访问器的属性，但派生类只有 get 访问器，则派生类属性将隐藏基类属性，并且您将无法访问基类上的 setter。

3. 自定义属性不是通用类型系统的一部分。

除非数组或 COM 类型已加载到可用类的表中，否则不会搜索它们。

typeName 可以是由其命名空间限定的类型名称，也可以是包含程序集名称规范的程序集限定名称。 请参阅 AssemblyQualifiedName。

如果 typeName 包括命名空间，但不包括程序集名称，则此方法仅搜索调用对象的程序集，并按该顺序 mscorlib.dll/System.Private.CoreLib.dll。 如果 typeName 使用部分或完整程序集名称完全限定，则此方法在指定的程序集中搜索。 如果程序集具有强名称，则需要完整的程序集名称。

属性 AssemblyQualifiedName 返回一个完全限定的类型名称，包括嵌套类型、程序集名称和类型参数。 支持公共语言运行时的所有编译器都将发出嵌套类的简单名称，并且反射在查询时会根据以下约定构造一个错误名称。

例如，类的完全限定名称可能如下所示：

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

如果命名空间为 TopNamespace.Sub+Namespace，则字符串必须在加号 (+) 前面加上转义字符 (\) ，以防止将其解释为嵌套分隔符。 反射发出此字符串，如下所示：

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

“++”变为“\+\+”，“\”变为“\\”。

此限定名称可以持久保存，稍后用于加载 Type。 若要搜索和加载 Type，请 GetType 仅将 与类型名称一起使用，或与程序集限定的类型名称一起使用。 GetType 具有类型名称的 将在调用方程序集中查找 Type ，然后在系统程序集中查找 。 GetType 具有程序集限定的类型名称将在任何程序集中查找 Type 。

类型名称可能包含表示有关类型的其他信息的尾随字符，例如类型是引用类型、指针类型还是数组类型。 若要检索不包含这些尾随字符的类型名称，请使用 t.GetElementType().ToString()，其中 t 是 类型。

空格与除程序集名称以外的所有类型名称组件相关。 在程序集名称中，“，”分隔符前的空格是相关的，但“，”分隔符后面的空格将被忽略。

泛型类型的名称以反引号 (') 结尾，后跟表示泛型类型参数数的数字。 此名称整型的目的是允许编译器支持同名但类型参数数量不同的泛型类型，这些类型参数在同一范围内发生。 例如，反射从泛型方法和 Tuple(Of T0, T1) Visual Basic Tuple<T> 或 Visual C# 中的 和 返回经过修改的名称Tuple`1Tuple`2和Tuple<T0, T1>。Tuple(Of T)

对于泛型类型，类型参数列表用方括号括起来，类型参数用逗号分隔。 例如，泛型 Dictionary<TKey,TValue> 有两个类型参数。 Dictionary<TKey,TValue>MyType具有 类型String键的 ，可以按如下所示表示：

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

若要在类型参数列表中指定程序集限定类型，请将程序集限定类型括在方括号内。 否则，分隔程序集限定名称部分的逗号将被解释为分隔其他类型参数。 例如，Dictionary<TKey,TValue>MyType可以按如下所示指定来自 MyAssembly.dll 的 ，其键类型String为 ：

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

可以为 Null 的类型是泛型类型的特例。 例如，可为 null 值 Int32 由字符串“System.Nullable'1[System.Int32]”表示。

下表显示了用于各种类型的语法 GetType 。

另请参阅

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• 指定完全限定的类型名称

Source:

Type.CoreCLR.cs

Source:

Type.CoreCLR.cs

Source:

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

参数

返回

具有指定名称的类型，如果未找到该类型，则返回 null。

例外

注解

此方法的使用方案以及有关 assemblyResolver 和 typeResolver 参数的详细信息可在方法重载中找到 GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) 。

调用此方法重载与调用 GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) 方法重载并指定 falsethrowOnError 和 ignoreCase 参数相同。

Source:

Type.CoreCLR.cs

Source:

Type.CoreCLR.cs

Source:

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

参数

返回

具有指定名称的类型。 如果找不到该类型，则 throwOnError 参数指定是返回 null 还是引发异常。 在某些情况下，将引发异常，而不考虑 throwOnError 的值。 请参见“异常”部分。

例外

注解

此方法的使用方案以及有关 assemblyResolver 和 typeResolver 参数的详细信息可在方法重载中找到 GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean) 。

调用此方法重载与调用GetType(String, Func<AssemblyName,Assembly>, Func<Assembly,String,Boolean,Type>, Boolean, Boolean)方法重载并指定falseignoreCase参数相同。