База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

AttributeUsageAttribute — правила за потребителски атрибути

AttributeUsageAttribute указва къде може да се прилага потребителски атрибут, дали може да се повтаря и дали се наследява. AttributeTargets.Property ограничава употребата му до свойства.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

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

System.AttributeUsageAttribute, записван като [AttributeUsage(...)], се поставя върху клас на потребителски атрибут, наследен от Attribute. Той задава правилата за прилагане на този атрибут, а не поведението на обектите, маркирани с него.

Аргументът на конструктора от тип AttributeTargets определя свойството само за четене ValidOn. Това е изброим тип с флагове: комбинирайте целите с |, например AttributeTargets.Property | AttributeTargets.Field. Самостоятелно AttributeTargets.Property разрешава свойства, но не и полета или методите за достъп get и set. Непозволена цел води до грешка при компилация.

AllowMultiple определя дали атрибутът може да се появи многократно върху един елемент; стойността по подразбиране е false. Inherited определя дали атрибутът се наследява от производни класове и предефинирани членове; стойността по подразбиране е true. Това не означава, че самият клас на атрибута се наследява. Правилата по подразбиране без изрично ограничение съответстват на AttributeTargets.All, AllowMultiple = false, Inherited = true.

В примера LabelAttribute може да се появи само веднъж върху свойство и не се наследява. [Label("Product name")] записва метаданни за Name; кодът ги прочита чрез рефлексия. Самият атрибут не проверява стойността на свойството. Използваните API са налични в .NET 10; примерът не изисква езикови функции във версия preview.

Примери

using System;

[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = false)]
public sealed class LabelAttribute : Attribute
{
    public LabelAttribute(string text) => Text = text;
    public string Text { get; }
}

public sealed class Product
{
    [Label("Product name")]
    public string Name { get; set; } = "";
}

public static class Program
{
    public static void Main()
    {
        var property = typeof(Product).GetProperty(nameof(Product.Name))!;
        var label = (LabelAttribute)Attribute.GetCustomAttribute(
            property, typeof(LabelAttribute))!;
        Console.WriteLine(label.Text);
    }
}

Резултат

Product name

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници