Полное руководство. С# 4.0

Шилдт Герберт

С помощью методов и свойств класса Туре можно получить подробные сведения о типе данных во время выполнения программы. Это довольно эффективное средство. Ведь получив сведения о типе данных, можно сразу же вызвать его конструкторы и методы или воспользоваться его свойствами. Следовательно, рефлексия позволяет ис пользовать код, который не был доступен во время компиляции.

Прикладной интерфейс Reflection API весьма обширен и поэтому не может быть полностью рассмотрен в этой главе. Ведь для этого потребовалась бы целая книга! Но прикладной интерфейс Reflection API имеет ясную логическую структуру, а следова тельно, уяснив одну его часть, нетрудно понять и все остальное. Принимая во внима ние это обстоятельство, в последующих

разделах демонстрируются четыре основных способа применения рефлексии: получение сведений о методах, вызов методов, кон струирование объектов и загрузка типов данных из сборок. Получение сведений о методах

Имея в своем распоряжении объект класса Туре, можно получить список методов, поддерживаемых отдельным типом данных, используя метод GetMethods. Ниже приведена одна из форм, подходящих для этой цели. MethodInfo[] GetMethods

Этот метод возвращает массив объектов класса MethodInfo, которые описывают методы, поддерживаемые вызывающим типом. Класс MethodInfo находится в про странстве имен System.Reflection.

Класс MethodInfo является производным от абстрактного класса MethodBase, ко торый в свою очередь наследует от класса MemberInfо. Это дает возможность пользо ваться всеми свойствами и методами, определенными в этих трех классах. Например, для получения имени метода служит свойство Name. Особый интерес вызывают два члена класса MethodInfo:ReturnType и GetParameters.

Возвращаемый тип метода находится в доступном только для чтения свойстве ReturnType, которое является объектом класса Туре.

Метод GetParameters возвращает список параметров, связанных с анализируе мым методом. Ниже приведена его общая форма. ParameterInfо[] GetParameters;

Сведения о параметрах содержатся в объекте класса ParameterInfо. В классе ParameterInfо определено немало свойств и методов, описывающих параметры. Особое значение имеют два свойства: Name — представляет собой строку, содержащую имя параметра, a ParameterType — описывает тип параметра, который инкапсули рован в объекте класса Туре.

В качестве примера ниже приведена программа, в которой рефлексия используется для получения методов, поддерживаемых классом MyClass. В этой программе выво дится возвращаемый тип и имя каждого метода, а также имена и типы любых параме тров, которые может иметь каждый метод. // Анализ методов с помощью рефлексии. using System; using System.Reflection; class MyClass { int x; int y; public MyClass(int i, int j) { x = i; у = j; } public int Sum { return x+y; } public bool IsBetween(int i) { if(x < i && i < y) return true; else return false; } public void Set(int a, int b) { x = a; у = b; } public void Set(double a, double b) { x = (int) a; y = (int) b; } public void Show { Console.WriteLine(" x: {0}, у: {1}", x, y); } } class ReflectDemo { static void Main { Type t = typeof(MyClass); // получить объект класса Type, // представляющий класс MyClass Console.WriteLine("Анализ методов, определенных " + "в классе " + t.Name); Console.WriteLine; Console.WriteLine("Поддерживаемые методы: "); MethodInfo[] mi = t.GetMethods; // Вывести методы, поддерживаемые в классе MyClass. foreach(MethodInfo m in mi) { // Вывести возвращаемый тип и имя каждого метода. Console.Write(" " + m.ReturnType.Name + " " + m.Name + "("); // Вывести параметры. ParameterInfo[] pi = m.GetParameters; for(int i=0; i < pi.Length; i++) { Console.Write(pi[i].ParameterType.Name + " " + pi[i],Name); if(i+1 < pi.Length) Console.Write(", "); } Console.WriteLine(")"); Console.WriteLine; } } }

Эта программа дает следующий результат. Анализ методов, определенных в классе MyClass Поддерживаемые методы: Int32 Sum Boolean IsBetween(Int32 i) Void Set(Int32 a, Int32 b) Void Set(Double a, Double b) Void Show String ToString Boolean Equals(Object obj) Int32 GetHashCode Type GetType

Как видите, помимо методов, определенных в классе MyClass,

в данной программе выводятся также методы, определенные в классе object, поскольку все типы данных в C# наследуют от класса object. Кроме того, в качестве имен типов указываются имена структуры .NET. Обратите также внимание на то, что метод Set выводится дважды, поскольку он перегружается. Один из его вариантов принимает аргументы типа int, а другой — аргументы типа double.

Рассмотрим эту программу более подробно. Прежде всего следует заметить, что в классе MyClass определен открытый конструктор и ряд открытых методов, в том числе и перегружаемый метод Set.

Объект класса Туре, представляющий класс MyClass, создается в методе Main в следующей строке кода. Type t = typeof(MyClass); // получить объект класса Туре, // представляющий класс MyClass

Напомним, что оператор typeof возвращает объект класса Туре, представляющий конкретный тип данных (в данном случае — класс MyClass).

С помощью переменной t и прикладного интерфейса Reflection API в данной программе затем выводятся сведения о методах, поддерживаемых в классе MyClass. Для этого в приведенной ниже строке кода сначала выводится список соответствую щих методов. MethodInfo[] mi = t.GetMethods;

Затем в цикле foreach организуется обращение к элементам массива mi. На каж дом шаге этого цикла выводится возвращаемый тип, имя и параметры отдельного ме тода, как показано в приведенном ниже фрагменте кода. foreach(MethodInfo m in mi) { // Вывести возвращаемый тип и имя каждого метода. Console.Write(" " + m.ReturnType.Name + " " + m.Name + "("); // Вывести параметры. ParameterInfo[] pi = m.GetParameters; for(int i=0; i < pi.Length; i++) { Console.Write(pi[i].ParameterType.Name + " " + pi[i].Name); if(i+1 < pi.Length) Console.Write(", "); } }

В этом фрагменте кода параметры, связанные с каждым методом, сначала создают ся с помощью метода GetParameters и сохраняются в массиве pi. Затем в цикле for происходит обращение к элементам массива pi и выводится тип и имя каждо го параметра. Самое главное, что все эти сведения создаются динамически во время выполнения программы, не опираясь на предварительную осведомленность о классе MyClass. Вторая форма метода GetMethods

Существует вторая форма метода GetMethods, позволяющая указывать различ ные флажки для отфильтровывания извлекаемых сведений о методах. Ниже приведе на эта общая форма метода GetMethods. MethodInfo[] GetMethods(BindingFlags флажки)

В этом варианте создаются только те методы, которые соответствуют указанным критериям. BindingFlags представляет собой перечисление. Ниже перечислен ряд наиболее часто используемых его значений. Значение Описание DeclaredOnly Извлекаются только те методы, которые определены в заданном классе. Унаследованные методы в извлекаемые сведения не включаются Instance Извлекаются методы экземпляра NonPublic Извлекаются методы, не являющиеся открытыми Public Извлекаются открытые методы Static Извлекаются статические методы

Два или несколько флажков можно объединить с помощью логической операции ИЛИ. Но как минимум флажок Instance или Static следует указывать вместе с флажком Public или NonPublic. В противном случае не будут извлечены сведения ни об одном из методов.

Форма BindingFlags метода GetMethods чаще всего применяется для полу чения списка методов, определенных в классе, без дополнительного извлечения на следуемых методов. Это особенно удобно в тех случаях, когда требуется исключить по лучение сведений о методах, определяемых в классе конкретного объекта. В качестве примера попробуем выполнить следующую замену в вызове метода GetMethods из предыдущей программы. // Теперь получаются сведения только о тех методах, // которые объявлены в классе MyClass. MethodInfo[] mi = t.GetMethods(BindingFlags.DeclaredOnly | BindingFlags.Instance | BindingFlags.Public);