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

Следующий пример показывает, как использовать атрибут System.ObsoleteAttribute, помечающий код как устаревший. Атрибуту передается строка "Будет удалено в следующей версии". Этот атрибут заставляет компилятор выдать переданную строку как предупреждение при компиляции помеченного кода.

C#

using System;
public class MainApp {
 public static void Main {
 //На этой строке компилятор выдаст предупреждение.
 int MyInt = Add(2,2);
 }

//В C# атрибуты задаются в квадратных скобках.
 //Этот атрибут применяется только к методу Add.
 [Obsolete("В следующей версии метод будет удален")]
 public static int Add(int a, int b) {
 return (a + b);
 }
}

MC++

#using <mscorlib.dll>
using namespace System;
int Add(int a, int b);

void main(void) {
 //На этой строке компилятор выдаст предупреждение.
 int MyInt = Add(2, 2);
 return;
}

//В MC++ атрибуты задаются в квадратных скобках.
//Этот атрибут применяется только к методу Add.
[Obsolete(S"В следующей версии метод будет удален")]
int Add(int a, int b) {
 return (a + b);
}

Visual Basic.NET

Imports System
Public Module main
Sub Main
 'На этой строке компилятор выдаст предупреждение.
 Dim MyInt as Integer = Add(2,2)
End Sub

' В Visual Basic.NET атрибуты задаются между скобками < и >.
' Этот атрибут применяется только к методу Add.
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.