Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

AttributeUsageAttribute — regole per gli attributi personalizzati

AttributeUsageAttribute specifica dove è possibile applicare un attributo personalizzato, se può essere ripetuto e se viene ereditato. AttributeTargets.Property ne limita l’uso alle proprietà.

Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintassi

[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]

System.AttributeUsageAttribute, scritto come [AttributeUsage(...)], si applica a una classe di attributo personalizzato derivata da Attribute. Definisce le regole di applicazione dell’attributo, non il comportamento degli oggetti contrassegnati con esso.

L’argomento del costruttore di tipo AttributeTargets determina la proprietà di sola lettura ValidOn. È un’enumerazione di flag: combina i tipi di destinazione con |, ad esempio AttributeTargets.Property | AttributeTargets.Field. AttributeTargets.Property da solo consente le proprietà, ma non i campi né i metodi di accesso get e set. Una destinazione non consentita causa un errore di compilazione.

AllowMultiple controlla se l’attributo può comparire più volte sullo stesso elemento; il valore predefinito è false. Inherited controlla l’ereditarietà dell’attributo da parte delle classi derivate e dei membri sottoposti a override; il valore predefinito è true. Questo non significa che venga ereditata la classe dell’attributo stessa. In assenza di una restrizione esplicita, le regole predefinite corrispondono a AttributeTargets.All, AllowMultiple = false, Inherited = true.

Nell’esempio, LabelAttribute può comparire una sola volta su una proprietà e non viene ereditato. [Label("Product name")] registra metadati su Name; il codice li legge tramite reflection. L’attributo non convalida autonomamente il valore della proprietà. Le API utilizzate sono disponibili in .NET 10; l’esempio non richiede funzionalità del linguaggio in versione preview.

Esempi

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);
    }
}

Risultato

Product name

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti