Type.GetNestedType Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Obtiene un tipo específico anidado dentro del objeto Type actual.

Sobrecargas

GetNestedType(String)	Busca el tipo anidado público con el nombre especificado.
GetNestedType(String, BindingFlags)	Cuando se invalida en una clase derivada, busca el tipo anidado especificado y aplica las restricciones de enlace especificadas.

GetNestedType(String)

Source:

Type.cs

Busca el tipo anidado público con el nombre especificado.

public:
 Type ^ GetNestedType(System::String ^ name);

public Type? GetNestedType (string name);

member this.GetNestedType : string -> Type

Public Function GetNestedType (name As String) As Type

Parámetros

name

String

Cadena que contiene el nombre del tipo anidado que se va a obtener.

Devoluciones

Type

Objeto que representa el tipo anidado público con el nombre especificado, si se encuentra; en caso contrario, null.

Excepciones

ArgumentNullException

name es null.

Comentarios

La búsqueda name distingue mayúsculas de minúsculas.

Use el nombre simple de la clase anidada para name. No lo califique con el nombre de la clase externa. Para una clase anidada genérica, use el nombre mangled , es decir, anexe un acento grave y el número de argumentos genéricos. Por ejemplo, use la cadena "Inner'1" para obtener la clase Inner<T> anidada genérica (Inner(Of T) en Visual Basic). No incluya la sintaxis específica del lenguaje para los parámetros de tipo.

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 se oculta 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 ser hide-by-name u hide-by-name-and-signature.
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. Para 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á tener acceso 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 cierto incluso si el tipo genérico envolvente es un tipo construido cerrado.

Nota:

Si el objeto actual Type representa un tipo genérico definido en C#, Visual Basic o C++, sus tipos anidados son genéricos incluso si no tienen parámetros genéricos propios. Esto no es necesariamente cierto en 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

• String
• DefaultBinder
• GetNestedTypes()

GetNestedType(String, BindingFlags)

Source:

Type.cs

Cuando se invalida en una clase derivada, busca el tipo anidado especificado y aplica las restricciones de enlace especificadas.

public:
 abstract Type ^ GetNestedType(System::String ^ name, System::Reflection::BindingFlags bindingAttr);

public abstract Type? GetNestedType (string name, System.Reflection.BindingFlags bindingAttr);

abstract member GetNestedType : string * System.Reflection.BindingFlags -> Type

Public MustOverride Function GetNestedType (name As String, bindingAttr As BindingFlags) As Type

Parámetros

name

String

Cadena que contiene el nombre del tipo anidado que se va a obtener.

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

Objeto que representa el tipo anidado que cumple los requisitos especificados, si se encuentra; en caso contrario, es null.

Excepciones

ArgumentNullException

name es null.

Comentarios

Use el nombre simple de la clase anidada para name. No lo califique con el nombre de la clase externa. Para una clase anidada genérica, use el nombre mangled , es decir, anexe un acento grave y el número de parámetros genéricos. Por ejemplo, use la cadena "Inner'1" para obtener la clase Inner<T> anidada genérica (Inner(Of T) en Visual Basic). No incluya la sintaxis específica del lenguaje para los parámetros de tipo.

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 una devolución.

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

• Especifique BindingFlags.NonPublic para incluir 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 GetNestedType 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 cierto incluso si el tipo genérico envolvente es un tipo construido cerrado.

Nota:

Si el objeto actual Type representa un tipo genérico definido en C#, Visual Basic o C++, sus tipos anidados son genéricos incluso si no tienen parámetros genéricos propios. Esto no es necesariamente cierto en 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

• String
• BindingFlags
• DefaultBinder
• GetNestedTypes()