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

• В 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

' Один обязательный (позиционный) и один необязательный

'(именованный) параметры.

' …

' Один обязательный (позиционный) параметр.

Параметры, определенные как свойства, могут передаваться в произвольном порядке. Но обязательные параметры должны передаваться в том порядке, в котором они описаны в конструкторе. Следующий фрагмент кода показывает, как необязательный параметр может передаваться перед обязательным.

C#

// Именованный параметр помещается перед позиционным.

[MyAttribute(OptionalParameter = "дополнительные данные", false)]

MC++

// Именованный параметр помещается перед позиционным.

[MyAttribute(OptionalParameter = S"дополнительные данные", false)]

Visual Basic.NET

' Именованный параметр помещается перед позиционным.

Свойства определяются, если нужно передавать именованные параметры в конструкторы или легко и удобно получать значения полей атрибута. Следующий пример показывает, как реализовать простое свойство для пользовательского атрибута:

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;

}

Visual Basic.NET

Public Property MyProperty As Boolean

Get

Return Me.myvalue

End Get

Set

Me.myvalue = value

End Set

End Property

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

C#

[AttributeUsage(AttributeTargets.All)]

public class DeveloperAttribute : System.Attribute {

// Закрытые поля.

private string name;

private string level;

private bool reviewed;

// Конструктор принимает два обязательных параметра: имя и уровень.

public DeveloperAttribute(string name, string level) {

this.name = name;

this.level = level;

this.reviewed = false;

}

// Свойство Name.

// Только для чтения.

public virtual string Name {

get {

return name;

}

}

// Свойство Level.

// Только для чтения.

public virtual string Level {

get {

return level;

}

}

// Свойство Reviewed.

// Чтение / Запись.