CKTIS / C#
AttributeUsageAttribute — pravila za prilagođene atribute
AttributeUsageAttribute određuje gdje se prilagođeni atribut smije primijeniti, može li se ponavljati i nasljeđuje li se. AttributeTargets.Property ograničava njegovu upotrebu na svojstva.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]System.AttributeUsageAttribute, zapisan kao [AttributeUsage(...)], postavlja se na klasu prilagođenog atributa izvedenu iz Attribute. Definira pravila za primjenu tog atributa, a ne ponašanje objekata označenih njime.
Argument konstruktora tipa AttributeTargets određuje svojstvo samo za čitanje ValidOn. Riječ je o enumeraciji zastavica: ciljeve kombinirajte operatorom |, primjerice AttributeTargets.Property | AttributeTargets.Field. Sam AttributeTargets.Property dopušta svojstva, ali ne polja ni pristupne metode get i set. Nedopušten cilj uzrokuje pogrešku pri kompilaciji.
AllowMultiple određuje može li se atribut pojaviti više puta na jednom elementu; zadana je vrijednost false. Inherited određuje nasljeđuju li atribut izvedene klase i nadjačani članovi; zadana je vrijednost true. To ne znači da se nasljeđuje sama klasa atributa. Zadana pravila bez izričitog ograničenja odgovaraju vrijednostima AttributeTargets.All, AllowMultiple = false, Inherited = true.
U primjeru se LabelAttribute može pojaviti samo jednom na svojstvu i ne nasljeđuje se. [Label("Product name")] bilježi metapodatke za Name; kod ih čita refleksijom. Sam atribut ne provjerava vrijednost svojstva. Upotrijebljeni API-ji dostupni su u .NET 10; primjer ne zahtijeva jezične značajke u verziji preview.
Primjeri
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);
}
}Rezultat
Product name
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.