CKTIS / C#
AttributeUsageAttribute — regels voor aangepaste attributen
AttributeUsageAttribute geeft aan waar een aangepast attribuut mag worden toegepast, of het mag worden herhaald en of het wordt overgeërfd. AttributeTargets.Property beperkt het gebruik tot eigenschappen.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]System.AttributeUsageAttribute, geschreven als [AttributeUsage(...)], wordt geplaatst op een aangepaste attribuutklasse die is afgeleid van Attribute. Het bepaalt de regels voor het toepassen van dat attribuut, niet het gedrag van objecten die ermee zijn gemarkeerd.
Het constructorargument van het type AttributeTargets bepaalt de alleen-lezen eigenschap ValidOn. Dit is een flags-enumeratie: combineer doelen met |, bijvoorbeeld AttributeTargets.Property | AttributeTargets.Field. AttributeTargets.Property staat op zichzelf eigenschappen toe, maar geen velden of de toegangsmethoden get en set. Een niet-toegestaan doel veroorzaakt een compilatiefout.
AllowMultiple bepaalt of het attribuut meerdere keren op één element mag voorkomen; de standaardwaarde is false. Inherited bepaalt of het attribuut wordt overgeërfd door afgeleide klassen en overschreven leden; de standaardwaarde is true. Dit betekent niet dat de attribuutklasse zelf wordt overgeërfd. Zonder expliciete beperking komen de standaardregels overeen met AttributeTargets.All, AllowMultiple = false, Inherited = true.
In het voorbeeld mag LabelAttribute maar één keer op een eigenschap voorkomen en wordt het niet overgeërfd. [Label("Product name")] slaat metagegevens op bij Name; de code leest deze uit met reflection. Het attribuut controleert zelf de waarde van de eigenschap niet. De gebruikte API’s zijn beschikbaar in .NET 10; het voorbeeld vereist geen preview-taalfuncties.
Voorbeelden
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);
}
}Resultaat
Product name
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.