Type.GetNestedType Método

Definición

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)

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

public:
 Type ^ GetNestedType(System::String ^ name);
public:
 virtual Type ^ GetNestedType(System::String ^ name);
public Type? GetNestedType (string name);
public Type GetNestedType (string name);
member this.GetNestedType : string -> Type
abstract member GetNestedType : string -> Type
override 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

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

Implementaciones

Excepciones

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

Se aplica a

GetNestedType(String, BindingFlags)

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

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

Implementaciones

Excepciones

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:

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

Se aplica a