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

Jenter Алекс

Function <Obsolete("В следующей версии метод будет удален")>_

 Add(a as Integer, b as Integer) as Integer

 Add = a + b

End Function

End Module

Применение атрибутов на уровне сборок

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

C#

using System.Reflection;

[assembly:AssemblyName("Моя

сборка")]

MC++

using namespace System::Reflection;

[assembly:AssemblyName(S"Моя сборка")];

Visual Basic.NET

Imports System.Reflection

<Assembly:AssemblyName("Моя сборка")>

При компиляции кода строка "Моя сборка" помещается в манифест сборки в секции метаданных. Этот атрибут можно увидеть с помощью дизассемблера MSIL (Ildasm.exe) или с помощью пользовательских средств.

Применение атрибутов на уровне модулей

Для применения атрибутов на уровне модулей используется ключевое слово Module, в остальном все как на уровне сборок.

Пользовательские атрибуты

Чтобы разрабатывать собственные атрибуты, не нужно изучать что-то принципиально новое. Если вы знакомы с объектно-ориентированным программированием и знаете, как разрабатывать классы, вы знаете уже практически все. Пользовательские атрибуты – это классы, тем или иным образом наследующие от System.Attribute. Также как и все другие классы, пользовательские атрибуты содержат методы для записи и чтения данных. Рассмотрим процесс создания пользовательского атрибута по шагам.

Применение атрибута AttributeUsageAttribute

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

C#

[AttributeUsage(AttributeTargets.All, Inherited = false, AllowMultiple = true)]

MC++

[AttributeUsage(AttributeTargets::All, Inherited = false, AllowMultiple = true)]

Visual Basic.NET

<AttributeUsage(AttributeTargets.All, Inherited := False, AllowMultiple := true)>

Класс System.AttributeUsageAttribute содержит три члена, которые важны для создания пользовательских атрибутов: AttributeTargets, Inherited и AllowMultiple.

Поле AttributeTargets

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

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

Также можно использовать несколько экземпляров атрибута AttributeTargets. В следующем примере показано, как пользовательский атрибут может применяться к любому классу или методу:

C#

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]

MC++

[AttributeUsage(AttributeTargets::Class | AttributeTargets::Method)]

Visual Basic.NET

<AttributeUsage(AttributeTargets.Class BitOr AttributeTargets.Method)>

Свойство Inherited

Это свойство определяет, будет ли атрибут наследоваться классами, наследниками того, к которому этот атрибут применен. Это свойство может принимать два значения: true или false.

C#

// По умолчанию Inherited = true.

public class MyAttribute : Attribute {}

// Явно задается false.

[AttributeUsage(Inherited = false)]

public class YourAttribute : Attribute {}

MC++

// По умолчанию Inherited = true.

public gc class MyAttribute : public System::Attribute {}

// Явно задается false.

[AttributeUsage(Inherited = false)]

public gc class YourAttribute : public System::Attribute {}

Visual Basic.NET

' По умолчанию Inherited := true.

Public Class _

 <AttributeUsage(AttributeTargets.All, Inherited := True)> MyAttribute

 Inherits Attribute

End Class

Public Class _

 <AttributeUsage(AttributeTargets.All, Inherited := False)> YourAttribute

 Inherits Attribute

End Class

Вышеописанные атрибуты затем применяются к методу класса MyClass:

C#

public class MyClass {

 // В C# несколько атрибутов могут определяться в разных блоках,

 // ограниченных скобками или в одном блоке – через запятую.

 // Порядок следования атрибутов неважен.

 [MyAttribute][YourAttribute]

 public void MyMethod {