Самые полезные атрибуты в C#: от новичка до профи

Основные встроенные атрибуты, которые должен знать каждый

Атрибуты в C# — это мощный механизм для добавления метаданных к коду. Они позволяют изменять поведение программы без изменения логики самих методов. Вот список самых полезных:

1. Атрибуты для отладки и документации

• [Obsolete("Сообщение", false)] — помечает устаревший код. Второй параметр — ошибка компиляции (true) или предупреждение (false).
• [Conditional("DEBUG")] — метод будет вызываться только при определенном символе компиляции. Идеально для отладочного логирования.
• [DebuggerStepThrough] — пропускает метод при пошаговой отладке (удобно для свойств и мелких утилит).

2. Атрибуты для сериализации и работы с данными

• [Serializable] — разрешает сериализацию класса.
• [XmlIgnore] / [JsonIgnore] — исключает свойство из сериализации.
• [DefaultValue] — задает значение по умолчанию для свойства.

3. Атрибуты для валидации (DataAnnotations)

public class User
{
    [Required(ErrorMessage = "Имя обязательно")]
    [StringLength(50, MinimumLength = 2)]
    public string Name { get; set; }

    [Range(18, 120)]
    public int Age { get; set; }
}

4. Создание собственного атрибута (самое интересное!)

Вернемся к вашей проблеме с проверкой доступа. Вот как это решается через кастомный атрибут + AOP-подход:

[AttributeUsage(AttributeTargets.Method, AllowMultiple = false)]
public class RequireRoleAttribute : Attribute
{
    public string Role { get; }
    public RequireRoleAttribute(string role) => Role = role;
}

// Класс-перехватчик (упрощенная версия)
public class SecureInvoker
{
    public static void Invoke(object obj, string methodName, params object[] args)
    {
        var method = obj.GetType().GetMethod(methodName);
        var attr = method.GetCustomAttribute<RequireRoleAttribute>();
        
        if (attr != null && !HasAccess(attr.Role))
        {
            Console.WriteLine($"Доступ запрещен. Требуется роль: {attr.Role}");
            return;
        }
        
        method.Invoke(obj, args);
    }
    
    private static bool HasAccess(string role) => true; // ваша логика
}

// Использование
public class UserService
{
    [RequireRole("Admin")]
    public void DeleteUser(int userId) 
    {
        Console.WriteLine("Пользователь удален");
    }
}

// Вызов
var service = new UserService();
SecureInvoker.Invoke(service, nameof(service.DeleteUser), 123);

5. Атрибут для логирования (еще один пример)

[AttributeUsage(AttributeTargets.Method)]
public class LogAttribute : Attribute { }

public class LoggerInvoker
{
    public static void InvokeWithLog(object obj, string methodName, params object[] args)
    {
        var method = obj.GetType().GetMethod(methodName);
        if (method.GetCustomAttribute<LogAttribute>() != null)
        {
            Console.WriteLine($"[LOG] Вызов {methodName} в {DateTime.Now}");
        }
        method.Invoke(obj, args);
    }
}

Советы по использованию

• Не злоупотребляйте атрибутами — они добавляют метаданные, но не заменяют нормальную архитектуру
• Для AOP (аспектно-ориентированного программирования) лучше использовать готовые библиотеки: PostSharp, Castle.Core (DynamicProxy), Autofac
• Атрибуты работают на этапе компиляции, поэтому их нельзя изменить во время выполнения

В реальных проектах атрибуты активно используются в ASP.NET Core (маршрутизация, авторизация), Entity Framework (конфигурация моделей) и при работе с JSON/XML. Освоив их, вы сможете писать более чистый и декларативный код.

// Установите NuGet: Install-Package Castle.Core

public class LoggingInterceptor : IInterceptor
{
    public void Intercept(IInvocation invocation)
    {
        var method = invocation.Method;
        if (method.GetCustomAttribute<LogAttribute>() != null)
        {
            Console.WriteLine($"Вызов {method.Name}");
        }
        invocation.Proceed(); // выполняем оригинальный метод
    }
}

// Использование
var generator = new ProxyGenerator();
var service = generator.CreateClassProxy<UserService>(new LoggingInterceptor());
service.DeleteUser(123); // теперь логируется автоматически