Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

AttributeUsageAttribute — pravila za lastne atribute

AttributeUsageAttribute določa, kje je mogoče uporabiti lastni atribut, ali se lahko ponovi in ali se deduje. AttributeTargets.Property njegovo uporabo omejuje na lastnosti.

Različica: .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 kot [AttributeUsage(...)], se namesti na razred lastnega atributa, ki izhaja iz Attribute. Določa pravila za uporabo tega atributa, ne pa vedenja objektov, označenih z njim.

Argument konstruktorja tipa AttributeTargets določa lastnost samo za branje ValidOn. Gre za naštevalni tip z zastavicami: cilje lahko združite z operatorjem |, na primer AttributeTargets.Property | AttributeTargets.Field. Sam AttributeTargets.Property dovoljuje lastnosti, ne pa polj ali dostopnih metod get in set. Nedovoljen cilj povzroči napako pri prevajanju.

AllowMultiple določa, ali se lahko atribut na enem elementu pojavi večkrat; privzeta vrednost je false. Inherited določa dedovanje atributa v izpeljanih razredih in prepisanih članih; privzeta vrednost je true. To ne pomeni, da se deduje sam razred atributa. Privzeta pravila brez izrecne omejitve ustrezajo vrednostim AttributeTargets.All, AllowMultiple = false, Inherited = true.

V primeru se lahko LabelAttribute na lastnosti pojavi samo enkrat in se ne deduje. [Label("Product name")] zabeleži metapodatke za Name; koda jih prebere z refleksijo. Atribut sam ne preverja vrednosti lastnosti. Uporabljeni API-ji so na voljo v .NET 10; primer ne zahteva jezikovnih funkcij v različici preview.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri