Программирование на Visual C++. Архив рассылки

 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;