Type.GetNestedTypes Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Obtiene los tipos anidados dentro del objeto Type actual.

Sobrecargas

GetNestedTypes()	Devuelve los tipos públicos anidados en el objeto Type actual.
GetNestedTypes(BindingFlags)	Cuando se invalida en una clase derivada, busca los tipos anidados en el objeto Type actual y aplica las restricciones de enlace especificadas.

GetNestedTypes()

Source:

Type.cs

Devuelve los tipos públicos anidados en el objeto Type actual.

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

public Type[] GetNestedTypes ();

member this.GetNestedTypes : unit -> Type[]

Public Function GetNestedTypes () As Type()

Devoluciones

Type[]

Una matriz de objetos Type que representan los tipos públicos anidados en el objeto Type actual (la búsqueda no es recursiva), o una matriz vacía de tipo Type si no hay tipos públicos anidados en el objeto Type actual.

Ejemplos

En el ejemplo siguiente se define una clase anidada y en structMyClassy, a continuación, se obtienen objetos de los tipos anidados mediante el tipo de 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

Comentarios

En .NET 6 y versiones anteriores, el GetNestedTypes método no devuelve tipos en un orden determinado, como orden alfabético o de declaración. El código no debe depender del orden en el que se devuelven los tipos, ya que ese orden varía. Sin embargo, a partir de .NET 7, el orden es determinista en función del orden de metadatos del ensamblado.

Solo se devuelven los tipos públicos anidados inmediatamente en el tipo actual; la búsqueda no es recursiva.

En la tabla siguiente se muestra qué miembros de una clase base devuelven los Get métodos al reflejar en un tipo.

Tipo de miembro	Estático	No estático
Constructor	No	No
Campo	No	Sí. Un campo siempre está ocultado por nombre y firma.
evento	No es aplicable	La regla del sistema de tipos común es que la herencia es la misma que la de los métodos que implementan la propiedad . La reflexión trata las propiedades como hide-by-name-and-signature. Consulte la nota 2 a continuación.
Método	No	Sí. Un método (tanto virtual como no virtual) puede ocultarse por nombre u ocultar por nombre y firma.
Tipo anidado	No	No
Propiedad.	No es aplicable	La regla del sistema de tipos común es que la herencia es la misma que la de los métodos que implementan la propiedad . La reflexión trata las propiedades como hide-by-name-and-signature. Consulte la nota 2 a continuación.

1. Hide-by-name-and-signature tiene en cuenta todas las partes de la firma, incluidos modificadores personalizados, tipos de valor devuelto, tipos de parámetros, sentinels y convenciones de llamada no administradas. Se trata de una comparación binaria.

2. En el caso de la reflexión, las propiedades y los eventos son hide-by-name-and-signature. Si tiene una propiedad con un descriptor de acceso get y un set en la clase base, pero la clase derivada solo tiene un descriptor de acceso get, la propiedad de clase derivada oculta la propiedad de clase base y no podrá acceder al establecedor en la clase base.

3. Los atributos personalizados no forman parte del sistema de tipos común.

Si el objeto actual Type representa un parámetro de tipo en la definición de un tipo genérico o un método genérico, este método busca en los tipos anidados de la restricción de clase.

Si un tipo anidado es genérico, este método devuelve su definición de tipo genérico. Esto es true incluso si el tipo genérico envolvente es un tipo construido cerrado.

Nota:

Si el actual Type representa un tipo genérico definido en C#, Visual Basic o C++, sus tipos anidados son genéricos aunque no tengan parámetros genéricos propios. Esto no es necesariamente cierto de los tipos anidados definidos en ensamblados dinámicos o compilados con el Ilasm.exe (Ensamblador de IL).

Para obtener información sobre los tipos genéricos anidados y sobre la construcción de tipos genéricos anidados a partir de sus definiciones de tipos genéricos, vea MakeGenericType.

Consulte también

• GetNestedType(String)

GetNestedTypes(BindingFlags)

Source:

Type.cs

Cuando se invalida en una clase derivada, busca los tipos anidados en el objeto Type actual y aplica las restricciones de enlace especificadas.

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()

Parámetros

bindingAttr

BindingFlags

Combinación bit a bit de los valores de enumeración que especifican cómo se realiza la búsqueda.

O bien

Default para devolver null.

Devoluciones

Type[]

Una matriz de objetos Type que representan todos los tipos anidados en el objeto Type actual que cumplen las restricciones de enlace especificadas (la búsqueda no es recursiva), o una matriz vacía de tipo Type, si no se encuentran tipos anidados que cumplan las restricciones de enlace.

Ejemplos

En el ejemplo siguiente se crean dos clases públicas anidadas y dos clases protegidas anidadas, y se muestra información de las clases que coinciden con las restricciones de enlace especificadas.

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.

Comentarios

La búsqueda de tipos anidados no es recursiva.

En .NET 6 y versiones anteriores, el GetNestedTypes método no devuelve tipos en un orden determinado, como orden alfabético o de declaración. El código no debe depender del orden en el que se devuelven los tipos, ya que ese orden varía. Sin embargo, a partir de .NET 7, el orden es determinista en función del orden de metadatos del ensamblado.

Las marcas de filtro siguientes BindingFlags se pueden usar para definir qué tipos anidados se van a incluir en la búsqueda:

• Debe especificar o BindingFlags.PublicBindingFlags.NonPublic para obtener un retorno.

• Especifique BindingFlags.Public para incluir tipos anidados públicos en la búsqueda.

• Especifique BindingFlags.NonPublic que incluya tipos anidados no públicos (es decir, tipos anidados privados, internos y protegidos) en la búsqueda.

Este método devuelve solo los tipos anidados del tipo actual. No busca en las clases base del tipo actual. Para buscar tipos anidados en clases base, debe recorrer la jerarquía de herencia, llamando GetNestedTypes a cada nivel.

BindingFlags.Instance y BindingFlags.Static se omiten.

Llamar a este método con solo la BindingFlags.Public marca o solo la BindingFlags.NonPublic marca devolverá los tipos anidados especificados y no requiere ninguna otra marca.

Vea System.Reflection.BindingFlags para obtener más información.

Si el objeto actual Type representa un parámetro de tipo en la definición de un tipo genérico o un método genérico, este método busca en los tipos anidados de la restricción de clase.

Si un tipo anidado es genérico, este método devuelve su definición de tipo genérico. Esto es true incluso si el tipo genérico envolvente es un tipo construido cerrado.

Nota:

Si el actual Type representa un tipo genérico definido en C#, Visual Basic o C++, sus tipos anidados son genéricos aunque no tengan parámetros genéricos propios. Esto no es necesariamente cierto de los tipos anidados definidos en ensamblados dinámicos o compilados con el Ilasm.exe (Ensamblador de IL).

Para obtener información sobre los tipos genéricos anidados y sobre la construcción de tipos genéricos anidados a partir de sus definiciones de tipos genéricos, vea MakeGenericType.

Consulte también

• BindingFlags
• DefaultBinder
• GetNestedType(String)