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.