Type.GetNestedTypes Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Возвращает типы, вложенные в текущий объект Type.

Перегрузки

GetNestedTypes()	Возвращает открытые типы, вложенные в текущий объект Type.
GetNestedTypes(BindingFlags)	При переопределении в производном классе ищет типы, вложенные в текущий объект Type, используя заданные ограничения привязки.

GetNestedTypes()

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

Type.cs

Возвращает открытые типы, вложенные в текущий объект Type.

public:
 cli::array <Type ^> ^ GetNestedTypes();

public Type[] GetNestedTypes ();

member this.GetNestedTypes : unit -> Type[]

Public Function GetNestedTypes () As Type()

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

Type[]

Массив объектов Type, представляющий открытые типы, вложенные в текущий объект Type (нерекурсивный поиск), или пустой массив типа Type, если в текущий объект Type не вложен ни один открытый тип.

Примеры

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

using namespace System;
using namespace System::Reflection;
public ref class MyClass
{
public:
   ref class NestClass
   {
      public:
         static int myPublicInt = 0;
   };

   ref struct NestStruct
   {
      public:
         static int myPublicInt = 0;
   };
};

int main()
{
   try
   {
      // Get the Type object corresponding to MyClass.
      Type^ myType = MyClass::typeid;
      
      // Get an array of nested type objects in MyClass.
      array<Type^>^nestType = myType->GetNestedTypes();
      Console::WriteLine( "The number of nested types is {0}.", nestType->Length );
      System::Collections::IEnumerator^ myEnum = nestType->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Type^ t = safe_cast<Type^>(myEnum->Current);
         Console::WriteLine( "Nested type is {0}.", t );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Error {0}", e->Message );
   }
}

using System;
using System.Reflection;
public class MyClass
{
    public class NestClass
    {
        public static int myPublicInt=0;
    }
    public struct NestStruct
    {
        public static int myPublicInt=0;
    }
}

public class MyMainClass
{
    public static void Main()
    {
        try
        {
            // Get the Type object corresponding to MyClass.
            Type myType=typeof(MyClass);
            // Get an array of nested type objects in MyClass.
            Type[] nestType=myType.GetNestedTypes();
            Console.WriteLine("The number of nested types is {0}.", nestType.Length);
            foreach(Type t in nestType)
                Console.WriteLine("Nested type is {0}.", t.ToString());
        }
        catch(Exception e)
        {
            Console.WriteLine("Error"+e.Message);
        }
    }
}

Imports System.Reflection

Public Class MyClass1
    Public Class NestClass
        Public Shared myPublicInt As Integer = 0
    End Class

    Public Structure NestStruct
        Public myPublicInt As Integer
    End Structure 'NestStruct
End Class

Public Class MyMainClass
    Public Shared Sub Main()
        Try
            ' Get the Type object corresponding to MyClass.
            Dim myType As Type = GetType(MyClass1)
            ' Get an array of nested type objects in MyClass.                 
            Dim nestType As Type() = myType.GetNestedTypes()
            Console.WriteLine("The number of nested types is {0}.", nestType.Length)
            Dim t As Type
            For Each t In nestType
                Console.WriteLine("Nested type is {0}.", t.ToString())
            Next t
        Catch e As Exception
            Console.WriteLine("Error", e.Message.ToString())
        End Try
    End Sub
End Class

Комментарии

В .NET 6 и более ранних версиях GetNestedTypes метод не возвращает типы в определенном порядке, например в алфавитном порядке или порядке объявления. Код не должен зависеть от порядка, в котором возвращаются типы, так как этот порядок отличается. Однако, начиная с .NET 7, порядок является детерминированным на основе порядка метаданных в сборке.

Возвращаются только открытые типы, непосредственно вложенные в текущий тип; поиск не является рекурсивным.

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

Тип члена	Статические	Нестатическое
Конструктор	Нет	Нет
Поле	Нет	Да. Поле всегда является скрытием по имени и сигнатуре.
Событие	Неприменимо	Общее правило системы типов заключается в том, что наследование совпадает с наследованием методов, реализующих свойство . Отражение обрабатывает свойства как скрытие по имени и сигнатуре. См. примечание 2 ниже.
Метод	Нет	Да. Метод (как виртуальный, так и не виртуальный) может быть скрытием по имени или скрытием по имени и подписи.
Вложенный тип	Нет	Нет
Свойство.	Неприменимо	Общее правило системы типов заключается в том, что наследование совпадает с наследованием методов, реализующих свойство . Отражение обрабатывает свойства как скрытие по имени и сигнатуре. См. примечание 2 ниже.

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

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

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

Если текущий Type параметр представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск вложенных типов ограничения класса.

Если вложенный тип является универсальным, этот метод возвращает определение универсального типа. Это верно, даже если включающий универсальный тип является закрытым сконструированным типом.

Примечание

Если текущий Type тип представляет универсальный тип, определенный в C#, Visual Basic или C++, его вложенные типы являются универсальными, даже если у них нет собственных универсальных параметров. Это не обязательно относится к вложенным типам, определенным в динамических сборках или скомпилированным с помощьюIlasm.exe (ассемблер IL).

Сведения о вложенных универсальных типах и о создании вложенных универсальных типов на основе их определений универсальных типов см. в разделе MakeGenericType.

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

• GetNestedType(String)

GetNestedTypes(BindingFlags)

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

Type.cs

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

public:
 abstract cli::array <Type ^> ^ GetNestedTypes(System::Reflection::BindingFlags bindingAttr);

public abstract Type[] GetNestedTypes (System.Reflection.BindingFlags bindingAttr);

abstract member GetNestedTypes : System.Reflection.BindingFlags -> Type[]

Public MustOverride Function GetNestedTypes (bindingAttr As BindingFlags) As Type()

Параметры

bindingAttr

BindingFlags

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

-или-

Default для возврата null.

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

Type[]

Массив объектов Type, представляющий все типы, вложенные в текущий объект Type, удовлетворяющий заданным ограничениям привязки (нерекурсивный поиск), или пустой массив типа Type, если вложенные типы, удовлетворяющие ограничениям привязки, не найдены.

Примеры

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

using namespace System;
using namespace System::Reflection;

// Create a class with two nested public classes and two nested protected classes.
public ref class MyTypeClass
{
   public:
      ref class Myclass1{};
   
   public:
      ref class Myclass2{};
   
   protected:
      ref class MyClass3{};
   
   protected:
      ref class MyClass4{};
};

void DisplayTypeInfo(array<Type^>^ myArrayType)
{
   // Display the information for all the nested classes.
   for each (Type^ t in myArrayType)
      Console::WriteLine( "The name of the nested class is {0}.", t->FullName);
}

int main()
{
   Type^ myType = MyTypeClass::typeid;
   
   // Get the public nested classes.
   array<Type^>^myTypeArray = myType->GetNestedTypes( static_cast<BindingFlags>(BindingFlags::Public));
   Console::WriteLine( "The number of nested public classes is {0}.", myTypeArray->Length );
  
   // Display all the public nested classes.
   DisplayTypeInfo( myTypeArray );
   Console::WriteLine();
   
   // Get the nonpublic nested classes.
   array<Type^>^myTypeArray1 = myType->GetNestedTypes( static_cast<BindingFlags>(BindingFlags::NonPublic));
   Console::WriteLine( "The number of nested protected classes is {0}.", myTypeArray1->Length );
   
   // Display all the nonpublic nested classes.
   DisplayTypeInfo( myTypeArray1 );
}
// The example displays the following output:
//       The number of public nested classes is 2.
//       The name of the nested class is MyTypeClass+Myclass1.
//       The name of the nested class is MyTypeClass+Myclass2.
//       
//       The number of protected nested classes is 2.
//       The name of the nested class is MyTypeClass+MyClass3.
//       The name of the nested class is MyTypeClass+MyClass4.

using System;
using System.Reflection;

// Create a class with 2 nested public and 2 nested protected classes.
public class MyTypeClass
{
    public class Myclass1
    {
    }

    public class Myclass2
    {
    }

    protected class MyClass3
    {
    }

    protected class MyClass4
    {
    }
}

public class TypeMain
{
    public static void Main()
    {
        Type myType = (typeof(MyTypeClass));
        // Get the public nested classes.
        Type[] myTypeArray = myType.GetNestedTypes(BindingFlags.Public);
        Console.WriteLine("The number of nested public classes is {0}.", myTypeArray.Length);
        // Display all the public nested classes.
        DisplayTypeInfo(myTypeArray);
        Console.WriteLine();

        // Get the nonpublic nested classes.
        Type[] myTypeArray1 = myType.GetNestedTypes(BindingFlags.NonPublic|BindingFlags.Instance);
        Console.WriteLine("The number of nested protected classes is {0}.", myTypeArray1.Length);
        // Display all the nonpublic nested classes.
        DisplayTypeInfo(myTypeArray1);		
    }

    public static void DisplayTypeInfo(Type[] myArrayType)
    {
        // Display the information for all the nested classes.
        foreach (var t in myArrayType)
            Console.WriteLine("The name of the nested class is {0}.", t.FullName);
    }
}
// The example displays the following output:
//       The number of public nested classes is 2.
//       The name of the nested class is MyTypeClass+Myclass1.
//       The name of the nested class is MyTypeClass+Myclass2.
//
//       The number of protected nested classes is 2.
//       The name of the nested class is MyTypeClass+MyClass3.
//       The name of the nested class is MyTypeClass+MyClass4.

Imports System.Reflection

' Create a class with three properties.
Public Class MyTypeClass
    Public Class Myclass1
    End Class 

    Public Class Myclass2
    End Class 

    Protected Class MyClass3
    End Class 

    Protected Class MyClass4
    End Class 
End Class 

Public Class TypeMain
    Public Shared Sub Main()
        Dim myType As Type = GetType(MyTypeClass)

        ' Get the public nested classes.
        Dim myTypeArray As Type() = myType.GetNestedTypes((BindingFlags.Public))
        Console.WriteLine("The number of public nested classes is {0}.", myTypeArray.Length.ToString())
        ' Display all the public nested classes.
        DisplayTypeInfo(myTypeArray)
        Console.WriteLine()
        
        ' Get the nonpublic nested classes.
        Dim myTypeArray1 As Type() = myType.GetNestedTypes((BindingFlags.NonPublic))
        Console.WriteLine("The number of protected nested classes is {0}.", myTypeArray1.Length.ToString())
        ' Display  the information for all nested classes.
        DisplayTypeInfo(myTypeArray1)
    End Sub 

    Public Shared Sub DisplayTypeInfo(ByVal myArrayType() As Type)
        ' Display the information for all nested classes.
        For Each t In myArrayType
            Console.WriteLine("The name of the nested class is {0}.", t.FullName)
        Next 
    End Sub 
End Class  
' The example displays the following output:
'       The number of public nested classes is 2.
'       The name of the nested class is MyTypeClass+Myclass1.
'       The name of the nested class is MyTypeClass+Myclass2.
'       
'       The number of protected nested classes is 2.
'       The name of the nested class is MyTypeClass+MyClass3.
'       The name of the nested class is MyTypeClass+MyClass4.

Комментарии

Поиск вложенных типов не является рекурсивным.

В .NET 6 и более ранних версиях GetNestedTypes метод не возвращает типы в определенном порядке, например в алфавитном порядке или порядке объявления. Код не должен зависеть от порядка, в котором возвращаются типы, так как этот порядок отличается. Однако, начиная с .NET 7, порядок является детерминированным на основе порядка метаданных в сборке.

BindingFlags Следующие флаги фильтра можно использовать для определения вложенных типов, которые следует включить в поиск:

• Чтобы получить возврат, необходимо указать или BindingFlags.PublicBindingFlags.NonPublic .

• Укажите BindingFlags.Public , чтобы включить открытые вложенные типы в поиск.

• Укажите BindingFlags.NonPublic , чтобы включить в поиск не являющиеся открытыми вложенные типы (то есть частные, внутренние и защищенные вложенные типы).

Этот метод возвращает только вложенные типы текущего типа. Он не выполняет поиск по базовым классам текущего типа. Чтобы найти типы, вложенные в базовые классы, необходимо пройтись по иерархии наследования, вызывая GetNestedTypes на каждом уровне.

BindingFlags.Instance и BindingFlags.Static игнорируются.

Вызов этого метода только с флагом BindingFlags.Public или только флагом BindingFlags.NonPublic вернет указанные вложенные типы и не требует никаких других флагов.

Дополнительные сведения см. в разделе System.Reflection.BindingFlags.

Если текущий Type параметр представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск вложенных типов ограничения класса.

Если вложенный тип является универсальным, этот метод возвращает определение универсального типа. Это верно, даже если включающий универсальный тип является закрытым сконструированным типом.

Примечание

Если текущий Type тип представляет универсальный тип, определенный в C#, Visual Basic или C++, его вложенные типы являются универсальными, даже если у них нет собственных универсальных параметров. Это не обязательно относится к вложенным типам, определенным в динамических сборках или скомпилированным с помощьюIlasm.exe (ассемблер IL).

Сведения о вложенных универсальных типах и о создании вложенных универсальных типов на основе их определений универсальных типов см. в разделе MakeGenericType.

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

• BindingFlags
• DefaultBinder
• GetNestedType(String)