CKTIS / C#
AttributeUsageAttribute — pravidlá pre vlastné atribúty
AttributeUsageAttribute určuje, kde možno použiť vlastný atribút, či sa môže opakovať a či sa dedí. AttributeTargets.Property obmedzuje jeho použitie na vlastnosti.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]System.AttributeUsageAttribute, zapisovaný ako [AttributeUsage(...)], sa umiestňuje na triedu vlastného atribútu odvodenú od Attribute. Určuje pravidlá používania tohto atribútu, nie správanie objektov, ktoré sú ním označené.
Argument konštruktora typu AttributeTargets určuje vlastnosť iba na čítanie ValidOn. Ide o výčtový typ s príznakmi: ciele možno kombinovať operátorom |, napríklad AttributeTargets.Property | AttributeTargets.Field. Samotné AttributeTargets.Property povoľuje vlastnosti, nie polia ani prístupové metódy get a set. Nepovolený cieľ spôsobí chybu kompilácie.
AllowMultiple určuje, či sa atribút môže na jednom prvku vyskytovať opakovane; predvolená hodnota je false. Inherited určuje dedenie atribútu odvodenými triedami a prepísanými členmi; predvolená hodnota je true. Neznamená to, že sa dedí samotná trieda atribútu. Predvolené pravidlá bez výslovného obmedzenia zodpovedajú hodnotám AttributeTargets.All, AllowMultiple = false, Inherited = true.
V príklade sa LabelAttribute môže na vlastnosti vyskytovať iba raz a nededí sa. [Label("Product name")] ukladá metadáta k Name; kód ich načíta pomocou reflexie. Samotný atribút hodnotu vlastnosti neoveruje. Použité API sú dostupné v .NET 10; príklad nevyžaduje jazykové funkcie vo verzii preview.
Príklady
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);
}
}Výsledok
Product name
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.