CKTIS / C#
BindingFlags — filtrar miembros con reflexión
BindingFlags controla qué miembros de un tipo busca la reflexión. Combina los indicadores de visibilidad y tipo de miembro con | y usa DeclaredOnly para excluir los miembros heredados.
Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxis
typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)BindingFlags es una enumeración de indicadores de System.Reflection, utilizada, entre otras API, por Type.GetFields. Combina los valores con el operador bit a bit |, no con &. Es una API de la biblioteca .NET, no una característica del lenguaje que requiera LangVersion=preview; el ejemplo está dirigido a net10.0.
BindingFlags.Public selecciona los miembros públicos. BindingFlags.Instance incluye los miembros asociados a un objeto, mientras que BindingFlags.Static incluye los miembros estáticos. En una llamada a GetFields(flags), indica al menos un indicador de visibilidad (Public o NonPublic) y al menos uno de tipo de miembro (Instance o Static); de lo contrario, el resultado estará vacío. Puedes combinar ambos tipos de miembros.
BindingFlags.DeclaredOnly limita la búsqueda a los miembros declarados directamente en el tipo inspeccionado y excluye los heredados. No sustituye a los demás filtros. Sin este indicador, GetFields puede devolver campos de instancia heredados; para incluir campos estáticos públicos y protegidos de las clases base se necesita BindingFlags.FlattenHierarchy. Ni siquiera entonces se devuelven los campos estáticos privados de las clases base.
El ejemplo busca campos públicos de instancia y estáticos en Derived y, después, repite la búsqueda con DeclaredOnly. El campo BaseValue desaparece, mientras que el campo privado Hidden no aparece en ninguno de los resultados. Los nombres se ordenan explícitamente mediante StringComparer.Ordinal para que la salida no dependa del orden de los metadatos.
Ejemplos
using System;
using System.Reflection;
BindingFlags flags = BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static;
PrintFields(flags);
PrintFields(flags | BindingFlags.DeclaredOnly);
static void PrintFields(BindingFlags flags)
{
FieldInfo[] fields = typeof(Derived).GetFields(flags);
string[] names = Array.ConvertAll(fields, field => field.Name);
Array.Sort(names, StringComparer.Ordinal);
Console.WriteLine(string.Join(", ", names));
}
class Base
{
public int BaseValue = 1;
}
class Derived : Base
{
public static int Count = 2;
public string Name = "demo";
private int Hidden = 3;
}
Resultado
BaseValue, Count, Name Count, Name
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.