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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.