Type.GetType Метод

Исходный код:

Type.CoreCLR.cs

Исходный код:

Type.CoreCLR.cs

Исходный код:

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 см. в разделе Дополнительные примечания API для Type.GetType.

Исходный код:

Type.cs

Исходный код:

Type.cs

Исходный код:

Type.cs

public:
 Type ^ GetType();

public:
 virtual Type ^ GetType();

public Type GetType ();

override this.GetType : unit -> Type

Public Function GetType () As Type

Возвращаемое значение

Текущий контекст Type.

Реализации

Исключения

См. также раздел

• TypeLoadException
• Указание полных имен типов

Исходный код:

Type.CoreCLR.cs

Исходный код:

Type.CoreCLR.cs

Исходный код:

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

Комментарии

Метод можно использовать GetType для получения Type объекта для типа в другой сборке, если известно полное имя сборки, которое можно получить из AssemblyQualifiedName. GetType вызывает загрузку сборки, указанной в typeName. Вы также можете загрузить сборку Assembly.Load с помощью метода , а затем использовать Assembly.GetType метод или Assembly.GetTypes для получения Type объектов. Если тип находится в сборке, известной вашей программе во время компиляции, его эффективнее использовать typeof в C# или оператор в GetType Visual Basic.

GetType Работает только со сборками, загруженными с диска. При вызове GetType для поиска типа, определенного в динамической сборке, определенной System.Reflection.Emit с помощью служб, может возникнуть несогласованное поведение. Поведение зависит от того, является ли динамическая сборка постоянной, то есть созданной RunAndSave с помощью режимов доступа или Save перечисления System.Reflection.Emit.AssemblyBuilderAccess . Если динамическая сборка является постоянной и была записана на диск до GetType вызова, загрузчик находит сохраненную сборку на диске, загружает ее и извлекает тип из этой сборки. Если сборка не была сохранена на диск при GetType вызове , метод возвращает null. GetTypeне понимает временные динамические сборки; Таким образом, вызов GetType для получения типа в временной динамической сборке возвращает .null

Чтобы использовать GetType динамический модуль, подпишитесь на событие и вызовите GetType перед сохранениемAppDomain.AssemblyResolve. В противном случае вы получите две копии сборки в памяти.

В следующей таблице показано, какие члены базового класса возвращаются методами Get при отражении в типе.

1. Функция скрытия по имени и подписи учитывает все части сигнатуры, включая пользовательские модификаторы, типы возвращаемых значений, типы параметров, sentinels и неуправляемые соглашения о вызовах. Это двоичное сравнение.

2. Для отражения свойства и события представляют собой скрытие по имени и сигнатуре. Если у вас есть свойство с методом доступа get и set в базовом классе, но производный класс имеет только метод доступа get, свойство производного класса скрывает свойство базового класса, и вы не сможете получить доступ к методу задания в базовом классе.

3. Настраиваемые атрибуты не являются частью системы общих типов.

Массивы или COM-типы не выполняются для поиска, если они уже не загружены в таблицу доступных классов.

typeName может быть именем типа, квалифицированным пространством имен, или именем с указанием сборки, которое включает спецификацию имени сборки. См. раздел AssemblyQualifiedName.

Если typeName включает пространство имен, но не имя сборки, этот метод выполняет поиск только сборки вызывающего объекта и mscorlib.dll/System.Private.CoreLib.dll в этом порядке. Если typeName имеет полное или полное имя сборки, этот метод выполняет поиск в указанной сборке. Если сборка имеет строгое имя, требуется полное имя сборки.

Свойство AssemblyQualifiedName возвращает полное имя типа, включая вложенные типы, имя сборки и аргументы универсального типа. Все компиляторы, поддерживающие среду CLR, будут выдавать простое имя вложенного класса, а отражение создает искаженное имя при запросе в соответствии со следующими соглашениями.

Например, полное имя класса может выглядеть следующим образом:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Если пространство имен — TopNamespace.Sub+Namespace, то строка будет предшествовать знаку плюса (+) с escape-символом (\), чтобы предотвратить ее интерпретацию как вложенного разделителя. Отражение выдает эту строку следующим образом:

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

"++" становится "\+\+", а "\" — "\\".

Это полное имя можно сохранить, а затем использовать для загрузки Type. Для поиска и загрузки Typeиспользуйте GetType либо только имя типа, либо полное имя типа сборки. GetType с именем типа будет искать Type только в сборке вызывающего объекта, а затем в системной сборке. GetType с полным именем типа сборки будет искать в любой сборке Type .

Имена типов могут содержать конечные символы, обозначающие дополнительные сведения о типе, например, является ли тип ссылочным, типом указателя или типом массива. Чтобы получить имя типа без этих конечных символов, используйте t.GetElementType().ToString(), где t — это тип.

Пробелы относятся ко всем компонентам имен типов, кроме имени сборки. В имени сборки пробелы перед разделителем "," являются релевантными, но пробелы после разделителя "," игнорируются.

Имя универсального типа заканчивается обратным символом ('), за которым следуют цифры, представляющие количество аргументов универсального типа. Цель этого изменения имени — разрешить компиляторам поддерживать универсальные типы с тем же именем, но с разным количеством параметров типа, которые происходят в одной области. Например, отражение возвращает искаженные имена Tuple`1 и Tuple`2 из универсальных методов Tuple(Of T) и Tuple(Of T0, T1) в Visual Basic или Tuple<T> и Tuple<T0, T1> в Visual C#.

Для универсальных типов список аргументов типа заключен в квадратные скобки, а аргументы типа разделяются запятыми. Например, универсальный Dictionary<TKey,TValue> имеет два параметра типа. MyType Объект Dictionary<TKey,TValue> с ключами типа 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, — это особый случай универсальных типов. Например, значение Int32 NULL представлено строкой System.Nullable'1[System.Int32].

В следующей таблице показан синтаксис, используемый для GetType различных типов.

См. также раздел

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Указание полных имен типов

Исходный код:

Type.CoreCLR.cs

Исходный код:

Type.CoreCLR.cs

Исходный код:

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

Комментарии

Метод можно использовать GetType для получения Type объекта для типа в другой сборке, если известно полное имя сборки, которое можно получить из AssemblyQualifiedName. GetType вызывает загрузку сборки, указанной в typeName. Вы также можете загрузить сборку Assembly.Load с помощью метода , а затем использовать Assembly.GetType метод или Assembly.GetTypes для получения Type объектов. Если тип находится в сборке, известной вашей программе во время компиляции, его эффективнее использовать typeof в C# или оператор в GetType Visual Basic.

GetType Работает только со сборками, загруженными с диска. При вызове GetType для поиска типа, определенного в динамической сборке, определенной System.Reflection.Emit с помощью служб, может возникнуть несогласованное поведение. Поведение зависит от того, является ли динамическая сборка постоянной, то есть созданной RunAndSave с помощью режимов доступа или Save перечисления System.Reflection.Emit.AssemblyBuilderAccess . Если динамическая сборка является постоянной и была записана на диск до GetType вызова, загрузчик находит сохраненную сборку на диске, загружает ее и извлекает тип из этой сборки. Если сборка не была сохранена на диск при GetType вызове , метод возвращает null. GetTypeне понимает временные динамические сборки; Таким образом, вызов GetType для получения типа в временной динамической сборке возвращает .null

Чтобы использовать GetType динамический модуль, подпишитесь на событие и вызовите GetType перед сохранениемAppDomain.AssemblyResolve. В противном случае вы получите две копии сборки в памяти.

Параметр throwOnError указывает, что происходит, если тип не найден, а также подавляет некоторые другие условия исключения, как описано в разделе Исключения. Некоторые исключения возникают независимо от значения throwOnError. Например, если тип найден, но не может быть загружен, создается исключение , TypeLoadException даже если throwOnError имеет значение false.

В следующей таблице показано, какие члены базового класса возвращаются методами Get при отражении в типе.

1. Функция скрытия по имени и подписи учитывает все части сигнатуры, включая пользовательские модификаторы, типы возвращаемых значений, типы параметров, sentinels и неуправляемые соглашения о вызовах. Это двоичное сравнение.

2. Для отражения свойства и события представляют собой скрытие по имени и сигнатуре. Если у вас есть свойство с методом доступа get и set в базовом классе, но производный класс имеет только метод доступа get, свойство производного класса скрывает свойство базового класса, и вы не сможете получить доступ к методу задания в базовом классе.

3. Настраиваемые атрибуты не являются частью системы общих типов.

Массивы или COM-типы не выполняются для поиска, если они уже не загружены в таблицу доступных классов.

typeName может быть именем типа, квалифицированным пространством имен, или именем с указанием сборки, которое включает спецификацию имени сборки. См. раздел AssemblyQualifiedName.

Если typeName включает пространство имен, но не имя сборки, этот метод выполняет поиск только сборки вызывающего объекта и mscorlib.dll/System.Private.CoreLib.dll в этом порядке. Если typeName имеет полное или полное имя сборки, этот метод выполняет поиск в указанной сборке. Если сборка имеет строгое имя, требуется полное имя сборки.

Свойство AssemblyQualifiedName возвращает полное имя типа, включая вложенные типы, имя сборки и универсальные аргументы. Все компиляторы, поддерживающие среду CLR, будут выдавать простое имя вложенного класса, а отражение создает искаженное имя при запросе в соответствии со следующими соглашениями.

Например, полное имя класса может выглядеть следующим образом:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Если пространство имен — TopNamespace.Sub+Namespace, то строка будет предшествовать знаку плюса (+) с escape-символом (\), чтобы предотвратить ее интерпретацию как вложенного разделителя. Отражение выдает эту строку следующим образом:

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

"++" становится "\+\+", а "\" — "\\".

Это полное имя можно сохранить, а затем использовать для загрузки Type. Для поиска и загрузки Typeиспользуйте GetType либо только имя типа, либо полное имя типа сборки. GetType с именем типа будет искать Type только в сборке вызывающего объекта, а затем в системной сборке. GetType с полным именем типа сборки будет искать в любой сборке Type .

Имена типов могут содержать конечные символы, обозначающие дополнительные сведения о типе, например, является ли тип ссылочным, типом указателя или типом массива. Чтобы получить имя типа без этих конечных символов, используйте t.GetElementType().ToString(), где t — это тип.

Пробелы относятся ко всем компонентам имен типов, кроме имени сборки. В имени сборки пробелы перед разделителем "," являются релевантными, но пробелы после разделителя "," игнорируются.

Имя универсального типа заканчивается обратным символом ('), за которым следуют цифры, представляющие количество аргументов универсального типа. Цель этого изменения имени — разрешить компиляторам поддерживать универсальные типы с тем же именем, но с разным количеством параметров типа, которые происходят в одной области. Например, отражение возвращает искаженные имена Tuple`1 и Tuple`2 из универсальных методов Tuple(Of T) и Tuple(Of T0, T1) в Visual Basic или Tuple<T> и Tuple<T0, T1> в Visual C#.

Для универсальных типов список аргументов типа заключен в квадратные скобки, а аргументы типа разделяются запятыми. Например, универсальный Dictionary<TKey,TValue> имеет два параметра типа. MyType Объект Dictionary<TKey,TValue> с ключами типа 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, — это особый случай универсальных типов. Например, значение Int32 NULL представлено строкой System.Nullable'1[System.Int32].

В следующей таблице показан синтаксис, используемый для GetType различных типов.

См. также раздел

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Указание полных имен типов

Исходный код:

Type.CoreCLR.cs

Исходный код:

Type.CoreCLR.cs

Исходный код:

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. См. раздел "Исключения".

Исключения

Комментарии

Метод можно использовать GetType для получения Type объекта для типа в другой сборке, если известно полное имя сборки, которое можно получить из AssemblyQualifiedName. GetType вызывает загрузку сборки, указанной в typeName. Вы также можете загрузить сборку Assembly.Load с помощью метода , а затем использовать Assembly.GetType метод или Assembly.GetTypes для получения Type объектов. Если тип находится в сборке, известной вашей программе во время компиляции, его эффективнее использовать typeof в C# или оператор в GetType Visual Basic.

GetType Работает только со сборками, загруженными с диска. При вызове GetType для поиска типа, определенного в динамической сборке, определенной System.Reflection.Emit с помощью служб, может возникнуть несогласованное поведение. Поведение зависит от того, является ли динамическая сборка постоянной, то есть созданной RunAndSave с помощью режимов доступа или Save перечисления System.Reflection.Emit.AssemblyBuilderAccess . Если динамическая сборка является постоянной и была записана на диск до GetType вызова, загрузчик находит сохраненную сборку на диске, загружает ее и извлекает тип из этой сборки. Если сборка не была сохранена на диск при GetType вызове , метод возвращает null. GetTypeне понимает временные динамические сборки; Таким образом, вызов GetType для получения типа в временной динамической сборке возвращает .null

Чтобы использовать GetType динамический модуль, подпишитесь на событие и вызовите GetType перед сохранениемAppDomain.AssemblyResolve. В противном случае вы получите две копии сборки в памяти.

Параметр throwOnError указывает, что происходит, если тип не найден, а также подавляет некоторые другие условия исключения, как описано в разделе Исключения. Некоторые исключения возникают независимо от значения throwOnError. Например, если тип найден, но не может быть загружен, создается исключение , TypeLoadException даже если throwOnError имеет значение false.

В следующей таблице показано, какие члены базового класса возвращаются методами Get при отражении в типе.

1. Функция скрытия по имени и подписи учитывает все части сигнатуры, включая пользовательские модификаторы, типы возвращаемых значений, типы параметров, sentinels и неуправляемые соглашения о вызовах. Это двоичное сравнение.

2. Для отражения свойства и события представляют собой скрытие по имени и сигнатуре. Если у вас есть свойство с методом доступа get и set в базовом классе, но производный класс имеет только метод доступа get, свойство производного класса скрывает свойство базового класса, и вы не сможете получить доступ к методу задания в базовом классе.

3. Настраиваемые атрибуты не являются частью системы общих типов.

Массивы или COM-типы не выполняются для поиска, если они уже не загружены в таблицу доступных классов.

typeName может быть именем типа, квалифицированным пространством имен, или именем с указанием сборки, которое включает спецификацию имени сборки. См. раздел AssemblyQualifiedName.

Если typeName включает пространство имен, но не имя сборки, этот метод выполняет поиск только сборки вызывающего объекта и mscorlib.dll/System.Private.CoreLib.dll в этом порядке. Если typeName имеет полное или полное имя сборки, этот метод выполняет поиск в указанной сборке. Если сборка имеет строгое имя, требуется полное имя сборки.

Свойство AssemblyQualifiedName возвращает полное имя типа, включая вложенные типы, имя сборки и аргументы типа. Все компиляторы, поддерживающие среду CLR, будут выдавать простое имя вложенного класса, а отражение создает искаженное имя при запросе в соответствии со следующими соглашениями.

Например, полное имя класса может выглядеть следующим образом:

TopNamespace.SubNameSpace.ContainingClass+NestedClass,MyAssembly

Если пространство имен — TopNamespace.Sub+Namespace, то строка будет предшествовать знаку плюса (+) с escape-символом (\), чтобы предотвратить ее интерпретацию как вложенного разделителя. Отражение выдает эту строку следующим образом:

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

"++" становится "\+\+", а "\" — "\\".

Это полное имя можно сохранить, а затем использовать для загрузки Type. Для поиска и загрузки Typeиспользуйте GetType либо только имя типа, либо полное имя типа сборки. GetType с именем типа будет искать Type только в сборке вызывающего объекта, а затем в системной сборке. GetType с полным именем типа сборки будет искать в любой сборке Type .

Имена типов могут содержать конечные символы, обозначающие дополнительные сведения о типе, например, является ли тип ссылочным, типом указателя или типом массива. Чтобы получить имя типа без этих конечных символов, используйте t.GetElementType().ToString(), где t — это тип.

Пробелы относятся ко всем компонентам имен типов, кроме имени сборки. В имени сборки пробелы перед разделителем "," являются релевантными, но пробелы после разделителя "," игнорируются.

Имя универсального типа заканчивается обратным тиктиком ('), за которым следуют цифры, представляющие число аргументов универсального типа. Цель этого изменения имен заключается в том, чтобы позволить компиляторам поддерживать универсальные типы с тем же именем, но с разным количеством параметров типа, происходящих в одной области. Например, отражение возвращает искаженные имена Tuple`1 и Tuple`2 из универсальных методов Tuple(Of T) и Tuple(Of T0, T1) в Visual Basic или Tuple<T> и Tuple<T0, T1> в Visual C#.

Для универсальных типов список аргументов типа заключен в квадратные скобки, а аргументы типа разделяются запятыми. Например, универсальный Dictionary<TKey,TValue> тип имеет два параметра типа. MyType Объект Dictionary<TKey,TValue> с ключами типа 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, являются особым случаем универсальных типов. Например, значение Int32 NULL представлено строкой "System.Nullable'1[System.Int32]".

В следующей таблице показан синтаксис, используемый для GetType различных типов.

См. также раздел

• String
• TypeLoadException
• AssemblyQualifiedName
• GetAssembly(Type)
• GetType(String)
• AssemblyName
• Указание полных имен типов

Исходный код:

Type.CoreCLR.cs

Исходный код:

Type.CoreCLR.cs

Исходный код:

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 .

Исходный код:

Type.CoreCLR.cs

Исходный код:

Type.CoreCLR.cs

Исходный код:

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) метода и указанием false параметра ignoreCase .