MC++
public gc class MyClass {
public:
// В MC++ несколько атрибутов могут определяться в разных блоках,
// ограниченных скобками или в одном блоке – через запятую.
// Порядок следования атрибутов неважен.
[MyAttribute][YourAttribute]
void MyMethod() {
//…
}
}
Visual Basic.NET
' В Microsoft Visual Basic.NET несколько атрибутов разделяются запятыми.
' Порядок следования атрибутов неважен.
Public Class MyClass
Public Sub <MyAttribute, YourAttribute> MyMethod()
'…
End Sub
End Class
И, наконец, рассмотрим класс YourClass – наследник MyClass. С методом MyMethod этого класса будет связан только атрибут MyAttribute.
C#
public class YourClass : MyClass {
// Этот метод имеет только атрибут MyAttribute.
public void MyMethod() {
//…
}
}
MC++
public gc class YourClass : public MyClass {
public:
// Этот метод имеет только атрибут MyAttribute.
void MyMethod() {
//…
}
}
Visual Basic.NET
Public Class YourClass
Inherits MyClass
' Этот метод имеет только атрибут MyAttribute.
Public Sub MyMethod()
'…
End Sub
End Class
Свойство AllowMultipleЭто свойство показывает, может ли атрибут применяться многократно к одному элементу. По умолчанию оно равно false, что значит – атрибут может использоваться только один раз. Рассмотрим следующий пример:
C#
// По умолчанию AllowMultiple = false.
public class MyAttribute : Attribute {}
[AttributeUsage(AllowMultiple = true)]
public class YourAttribute : Attribute {}
MC++
// По умолчанию AllowMultiple = false.
public gc class MyAttribute : public System::Attribute {}
[AttributeUsage(AllowMultiple = true)]
public gc class YourAttribute : public System::Attribute {}
Visual Basic.NET
' По умолчанию AllowMultiple = false.
Public Class _
<AttributeUsage(AttributeTargets.Method)> MyAttribute
Inherits Attribute
End Class
Public Class _
<AttributeUsage(AttributeTargets.Method, AllowMultiple := True)> YourAttribute
Inherits Attribute
End Class
Если используется несколько экземпляров атрибутов, MyAttribute заставляет компилятор выдать сообщение об ошибке. Следующий фрагмент кода иллюстрирует правильное использование атрибута YourAttribute и неправильное – MyAttribute:
C#
public class MyClass {
// Ошибка – дублирование не разрешено.
[MyAttribute, MyAttribute]
public void MyMethod() {
//…
}
// Это допустимо.
[YourAttribute, YourAttribute] public void YourMethod() {
//…
}
}
MC++
public gc class MyClass {
public:
// Ошибка – дублирование не разрешено.
[MyAttribute, MyAttribute] void MyMethod() {
//…
}
// Это допустимо.
[YourAttribute, YourAttribute] void YourMethod() {
//…
}
}
Visual Basic.NET
Public Class MyClass
' Ошибка – дублирование не разрешено.
Public Sub <MyAttribute, MyAttribute> MyMethod()
'…
End Sub
' Это допустимо.
Public Sub <YourAttribute, YourAttribute> YourMethod()
'…
End Sub
End Class
Если свойства AllowMultiple и Inherited установлены в true, класс может наследовать атрибут и иметь еще экземпляры, примененные непосредственно к нему. Если же свойство AllowMultiple равно false, значения атрибутов родительского класса будут переписаны значениями этого же атрибута класса-наследника.
Типы данных, допустимые в атрибутахАтрибут может содержать поля следующих типов:
• Bool
• Byte
• Char
• Double
• Float
• Int
• Long
• Short
• String
• Object
• System.Type
Открытые перечислимые типы, вложенные (если вложены) в открытые типы
Попытка использовать в классе, реализующем атрибут другие типы, приводит к ошибкам компиляции.
Определение атрибутивного классаТеперь можно приступить к определению самого класса. Это определение выглядит подобно определению обычного класса, что демонстрирует следующий пример:
C#
// Этот атрибут может применяться только к методам
public class MyAttribute : System.Attribute {
// …
}
MC++
// Этот атрибут может применяться только к методам
public gc class MyAttribute : System.Attribute {
// …
}
Visual Basic.NET
' Этот атрибут может применяться только к методам
Public Class <AttributeUsage(AttributeTargets.Method)> MyAttribute
Inherits System.Attribute
' …
End Class
Этот пример показывает следующие положения:
• Атрибутивные классы должны объявляться как открытые
• По соглашению, имена классов должны заканчиваться словом Attribute. Хотя это и необязательно, рекомендуется поступать так для улучшения читаемости текста. При использовании атрибута это слово необязательно.
• Все атрибутивные классы должны, так или иначе, наследовать от System.Attribute.
• В Microsoft Visual Basic все пользовательские атрибутивные классы должны иметь атрибут AttributeUsageAttribute.
Определение конструкторовАтрибуты инициализируются конструкторами, так же как обычные классы. Следующий фрагмент кода иллюстрирует типичный конструктор атрибута. Этот открытый конструктор принимает один параметр и инициализирует переменную класса.
C#
public MyAttribute(bool myvalue) {
this.myvalue = myvalue;
}
MC++
public:
MyAttribute(bool myvalue) {
this->myvalue = myvalue;
}
Visual Basic.NET
Public Sub New(newvalue As Boolean)
Me.myvalue = newvalue
End Sub
Конструкторы можно перегружать, чтобы принимать различные комбинации параметров. Если для атрибутивного класса определены свойства, для инициализации можно использовать комбинацию позиционных и именованных параметров. Обычно все обязательные параметры объявляются как позиционные, а необязательные как именованные.
Следующий пример показывает примеры использования параметризованного конструктора для инициализации атрибута. Здесь предполагается, что атрибут имеет обязательный параметр типа Boolean и необязательный типа String.
C#
// Один обязательный (позиционный) и один
// необязательный (именованный) параметры.
[MyAttribute(false, OptionalParameter = "дополнительные данные")]
// Один обязательный (позиционный) параметр.
[MyAttribute(false)]
MC++
// Один обязательный (позиционный) и один необязательный
//(именованный) параметры.
[MyAttribute(false, OptionalParameter = S"дополнительные данные")]
// Один обязательный (позиционный) параметр.
[MyAttribute(false)]
Visual Basic.NET
' Один обязательный (позиционный) и один необязательный
'(именованный) параметры.
<MyAttribute(False, OptionalParameter := "дополнительные данные")>
' …
' Один обязательный (позиционный) параметр.
<MyAttribute(False)>
Параметры, определенные как свойства, могут передаваться в произвольном порядке. Но обязательные параметры должны передаваться в том порядке, в котором они описаны в конструкторе. Следующий фрагмент кода показывает, как необязательный параметр может передаваться перед обязательным.
C#
// Именованный параметр помещается перед позиционным.
[MyAttribute(OptionalParameter = "дополнительные данные", false)]
MC++
// Именованный параметр помещается перед позиционным.
[MyAttribute(OptionalParameter = S"дополнительные данные", false)]
Visual Basic.NET
' Именованный параметр помещается перед позиционным.
<MyAttribute(OptionalParameter := "дополнительные данные" , False)>
Определение свойствСвойства определяются, если нужно передавать именованные параметры в конструкторы или легко и удобно получать значения полей атрибута. Следующий пример показывает, как реализовать простое свойство для пользовательского атрибута:
C#
public bool MyProperty {
get {
return this.myvalue;
}
set {
this.myvalue = value;
}
}
MC++
public:
__property bool get_MyProperty() { return myvalue; }
__property void set_MyProperty(bool value) { myvalue = value; }
protected:
bool myvalue;
