Dim MyInt as Integer = Add(2,2)
End Sub
' В Visual Basic.NET атрибуты задаются между скобками < и >.
' Этот атрибут применяется только к методу Add.
Function _
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
При компиляции кода строка "Моя сборка" помещается в манифест сборки в секции метаданных. Этот атрибут можно увидеть с помощью дизассемблера 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
Класс 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
Свойство 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 _
MyAttribute
Inherits Attribute
End Class
Public Class _
YourAttribute
Inherits Attribute
End Class
Вышеописанные атрибуты затем применяются к методу класса MyClass:
C#
public class MyClass {
// В C# несколько атрибутов могут определяться в разных блоках,
// ограниченных скобками или в одном блоке – через запятую.
// Порядок следования атрибутов неважен.
[MyAttribute][YourAttribute]
public void MyMethod() {
//…
}
}
MC++
public gc class MyClass {
public:
// В MC++ несколько атрибутов могут определяться в разных блоках,
// ограниченных скобками или в одном блоке – через запятую.
// Порядок следования атрибутов неважен.
[MyAttribute][YourAttribute]
Читать дальше