Net framework 5, а также среды Visual Studio 2012 и C#

Глава.18 .Настраиваемые.атрибуты
атрибутов в этих скобках через запятую. Если конструктор класса атрибута не 
имеет параметров, круглые скобки можно опустить. Ну и, как уже упоминалось, 
суффикс 
Attribute
также является необязательным. Показанные далее строки 
приводят к одному и тому же результату и демонстрируют все возможные способы 
применения набора атрибутов:
[Serializable][Flags]
[Serializable, Flags]
[FlagsAttribute, SerializableAttribute]
[FlagsAttribute()][Serializable()]
Определение класса атрибутов
Вы уже знаете, что любой атрибут представляет собой экземпляр класса, производ-
ного от 
System.Attribute
, и умеете применять атрибуты. Пришло время рассмо-
треть процесс их создания. Представьте, что вы работаете в Microsoft и получили 
задание реализовать поддержку битовых флагов в перечислимых типах. Для начала 
нужно определить класс 
FlagsAttribute
:
namespace System {
public class FlagsAttribute : System.Attribute {
public FlagsAttribute() {
}
}
}
Обратите внимание, что класс 
FlagsAttribute
наследует от класса 
Attribute
; 
именно это делает его CLS-совместимым. Вдобавок в имени класса присутствует 
суффикс 
Attribute
. Это соответствует стандарту именования, хотя и не является 
обязательным. Наконец, все неабстрактные атрибуты должны содержать хотя бы 
один открытый конструктор. Простейший конструктор
FlagsAttribute
не имеет 
параметров и не выполняет никаких действий.
ВниМание
Атрибут.следует.рассматривать.как.логический.контейнер.состояния .Иначе.гово-
ря,.хотя.атрибут.и.является.классом,.этот.класс.должен.быть.крайне.простым .Он.
должен.содержать.всего.один.открытый.конструктор,.принимающий.обязательную.
(или.позиционную).информацию.о.состоянии.атрибута .Также.класс.может.содер-
жать.открытые.поля/свойства,.принимающие.дополнительную.(или.именованную).
информацию.о.состоянии.атрибута .В.классе.не.должно.быть.открытых.методов,.
событий.или.других.членов 
В.общем.случае.я.не.одобряю.использование.открытых.полей .Атрибутов.это.тоже.
касается .Лучше.воспользоваться.свойствами,.так.как.они.обеспечивают.большую.
гибкость.в.случаях,.когда.требуется.внести.изменения.в.реализацию.класса.атри-
бутов 

---

469
Определение.класса.атрибутов
Получается, что экземпляры класса 
FlagsAttribute
можно применять к чему 
угодно, хотя реально этот атрибут следует применять только к перечислимым ти-
пам. Нет смысла применять его к свойству или методу. Чтобы указать компилятору 
область действия атрибута, применим к классу атрибута экземпляр класса 
System.
AttributeUsageAttribute
:
namespace System {
[AttributeUsage(AttributeTargets.Enum, Inherited = false)]
public class FlagsAttribute : System.Attribute {
public FlagsAttribute() {
}
}
}
В этой новой версии экземпляр 
AttributeUsageAttribute
применяется к атри-
буту. В конце концов, атрибуты — это всего лишь классы, а значит, к ним, в свою 
очередь, можно применять другие атрибуты. Атрибут 
AttributeUsage
является 
простым классом, указывающим компилятору область действия настраиваемого 
атрибута. Все компиляторы имеют встроенную поддержку этого атрибута и при 
попытке применить его к недопустимому элементу выдают сообщение об ошибке. 
В рассматриваемом примере атрибут 
AttributeUsage
указывает, что экземпляры 
атрибута 
Flags
работают только с перечислимыми типами.
Так как все атрибуты являются типами, понять, как устроен класс 
AttributeUsageAttribute
, несложно. Вот исходный код этого класса в FCL:
[Serializable]
[AttributeUsage(AttributeTargets.Class, Inherited=true)]
public sealed class AttributeUsageAttribute : Attribute {
internal static AttributeUsageAttribute Default =
new AttributeUsageAttribute(AttributeTargets.All);
internal Boolean m_allowMultiple = false;
internal AttributeTargets m_attributeTarget = AttributeTargets.All;
internal Boolean m_inherited = true;
// Единственный открытый конструктор
public AttributeUsageAttribute(AttributeTargets validOn) {
m_attributeTarget = validOn;
}
internal AttributeUsageAttribute(AttributeTargets validOn,
Boolean allowMultiple, Boolean inherited) {
m_attributeTarget = validOn;
m_allowMultiple = allowMultiple;
m_inherited = inherited;
}
public Boolean AllowMultiple {
get { return m_allowMultiple; }
set { m_allowMultiple = value; }
}
продолжение


---

470