Type.GetNestedType Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Source:
- Type.cs
- Source:
- Type.cs
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 -> Typeabstract member GetNestedType : string -> Type
override this.GetNestedType : string -> TypePublic Function GetNestedType (name As String) As TypePará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. |
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.
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.
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)
- Source:
- Type.cs
- Source:
- Type.cs
- 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);public abstract Type GetNestedType (string name, System.Reflection.BindingFlags bindingAttr);abstract member GetNestedType : string * System.Reflection.BindingFlags -> TypePublic MustOverride Function GetNestedType (name As String, bindingAttr As BindingFlags) As TypePará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:
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.
