Характеристики типа как целого
Класс Type содержит больше трёх десятков методов, позволяющих получать информацию об описываемом типе. Так можно узнать какое-либо свойство типа или наличие (и значение) определённого атрибута, выяснить принадлежность типа к некоторому семейству.
Методы, позволяющие получать информацию о типе, приведены в таблице 2.1.
Вот, например, как можно с помощью этих свойств получить описание семейства типа:
string GetTypeDescription(Type type)
{ return type.IsClass ? "class"
: type.IsInterface ? "interface"
: type.IsArray ? "array"
: type.IsEnum ? "enum"
: type.IsValueType ? "struct"
: "";
}
Таблица 2.1 - Методы, позволяющие получать информацию о типе
| IsAbstract | Является ли тип абстрактным классом или интерфейсом |
| IsClass | Класс ли это? (т.е. не value Type и не интерфейс) |
| IsSealed | Может ли тип иметь наследников? |
| IsInterface | Это интерфейс? (Заметьте, интерфейс - это не класс!) |
| IsCOMObject | А уж не COM-объект ли скрывается под видом класса .NET? |
| IsValueType | Это value type (тип-значение)? |
| IsEnum | Это перечисление? |
| IsPrimitive | Не является ли тип примитивным (т.е. одним из bool, byte, sbyte, short, ushort, int, uint, long, ulong, char, double, float)? |
| IsArray | Является ли тип массивом. Тип элементов массива можно получить с помощью свойства ElementType. |
| IsPointer | Является ли тип ссылкой? Тип указываемого объекта можно получить с помощью свойства ElementType. |
| IsByRef | А уж не тип ли это параметра, передаваемого по ссылке? Если да, то тип передаваемого объекта можно получить с помощью свойства ElementType. |
| HasElementType | HasElementType = IsArray || IsPointer || IsByRef. Т.е. тип является не самостоятельным типом, а лишь "производным от" ElementType. |
Члены класса
Для получения информации о членах класса имеется несколько групп (семейств) методов. Каждая группа обеспечивает получение информации об определённом типе членов класса. Например, информацию только о конструкторах класса, или только о его полях. Но есть одна группа методов, которые позволяют получать информацию сразу обо всех членах класса. Это семейство методов GetMembers.
public MemberInfo[] GetMembers();
public abstract MemberInfo[] GetMembers(BindingFlags);
В каждом семействе имеется не меньше двух методов, аналогичных приведенным выше. Один из этих методов возвращает массив, содержащий информацию об открытых (public) членах, а другой позволяет указать, информацию о каких членах класса следует возвращать. Например, если передать в качестве параметра BindingFlags.Public | BindingFlags.Instance, будут возвращены все открытые нестатические члены класса. Если вам нужна информация ещё и о статических членах, нужно добавить ещё один флаг BindingFlags.Static. А если вас интересуют не только открытые, но и закрытые члены, следует использовать флаг BindingFlags.NonPublic.
Ниже перечислены основные семейства методов класса Type, используемые для получения информации о членах класса.
Таблица 2.2 – Основные методы класса Type
| GetConstructors | Получение информации о конструкторах класса. Возвращает массив элементов типа ConstructorInfo. |
| GetCustomAttributes | Получение информации об атрибутах класса. Возвращает массив объектов-атрибутов. |
| GetEvents | Получение информации о событиях, поддерживаемых классом. Возвращает массив элементов типа EventInfo. |
| GetFields | Получение информации о полях класса. Возвращает массив элементов типа FieldInfo. |
| GetInterfaces | Получение информации об интерфейсах, реализованных или унаследованных классом. Возвращает массив элементов типа Type. |
| GetMembers | Получение информации о членах класса (включая свойства, методы, поля, события и т.д.) Возвращает массив элементов типа MemberInfo. |
| GetMethods | Получение информации о методах класса. Возвращает массив элементов типа MethodInfo. |
| GetNestedTypes | Получение информации о вложенных типах класса. Возвращает массив элементов типа Type. |
| GetProperties | Получение информации о свойствах (properties) класса. Возвращает массив элементов типа PropertyInfo. |
| GetTypeArray | Получение информации о типе элементов массива (если рассматриваемый тип является массивом). Возвращает соответствующий объект Type. |
Поскольку и конструкторы, и поля, и события, и методы, и свойства - это всё члены класса, то совершенно логично, что соответствующие им типы метаданных, (ConstructorInfo, EventInfo, FieldInfo, MethodInfo, PropertyInfo) унаследованы от типа MemberInfo.
Давайте рассмотрим пример получения информации обо всех конструкторах класса.
public static string TraceCtorsOf(Type type)
{ string trace = "";
ConstructorInfo[] arrCI = type.GetConstructors();
foreach (ConstructorInfo ci in arrCI)
{ trace += (ci.IsStatic ? "static " : "")
+ (ci.IsPrivate ? "private " : "")
+ (ci.IsFamily ? "protected " : "")
+ (ci.IsAssembly ? "internal " : "")
+ ci.Name;
ParameterInfo[] arrParamInfo = ci.GetParameters();
trace += "(";
for (int i = 0; i != arrParamInfo.Length; i++)
{ ParameterInfo parInf = arrParamInfo[i];
trace += (i != 0 ? ", " : "")
+ (parInf.IsIn ? "in " : "")
+ (parInf.IsOut ? "out " : "")
+ (parInf.IsOptional ? "optional ": "")
+ (parInf.IsLcid ? "lcid " : "")
+ parInf.ParameterType.Name + " "
+ parInf.Name
+ ((parInf.DefaultValue != DBNull.Value)
? (" = " + parInf.DefaultValue) : "")
;
}
trace += ");\r\n";
}
return trace;
}
В этом примере можно видеть, каким способом извлекается информация о параметрах методов. Каждая структура данных, отвечающая за методы-члены (EventInfo, MethodInfo, ConstructorInfo), имеет метод GetParameters(), возвращающий массив элементов типа ParameterInfo. Каждый элемент этого массива описывает отдельный параметр метода: его тип, имя, значение по умолчанию, направление передачи данных (in/out) и др.