Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori