field - Dichiarazioni di proprietà supportate dal campo

Importante

La field parola chiave è una funzionalità di anteprima in C# 13. È necessario usare .NET 9 e impostare l'elemento <LangVersion> su preview nel file di progetto per usare la field parola chiave contestuale.

È consigliabile prestare attenzione usando la funzionalità parola field chiave in una classe con un campo denominato field. La nuova field parola chiave ombreggiate un campo denominato field nell'ambito di una funzione di accesso alle proprietà. È possibile modificare il nome della field variabile oppure usare il @ token per fare riferimento all'identificatore field come @field. Per altre informazioni, leggere la specifica della funzionalità per la field parola chiave .

La parola chiave fieldcontestuale , aggiunta come funzionalità di anteprima in C# 13, può essere usata in una funzione di accesso alle proprietà per accedere al campo sottostante sintetizzato dal compilatore di una proprietà. Questa sintassi consente di definire il corpo di una get funzione di accesso o set e consentire al compilatore di generare l'altra funzione di accesso come in una proprietà implementata automaticamente.

L'aggiunta field delle parole chiave contestuali fornisce un percorso semplice per aggiungere vantaggi, ad esempio il controllo dell'intervallo a una proprietà implementata automaticamente. Questa procedura è illustrata nell'esempio seguente:

class TimePeriod4
{
    public double Hours {
        get;
        set => field = (value >= 0)
            ? value
            : throw new ArgumentOutOfRangeException(nameof(value), "The value must not be negative");
    }
}

È possibile implementare la Hours proprietà come proprietà implementata automaticamente. Si scopre quindi che si vuole proteggersi da un valore negativo. Si usa field e si specifica il controllo dell'intervallo nella set funzione di accesso. Non è necessario dichiarare il campo sottostante a mano e fornire un corpo per la get funzione di accesso.

Per altre informazioni, vedere gli articoli Proprietà e Indicizzatori.

Specifiche del linguaggio C#

Per altre informazioni, vedere la specifica del linguaggio C#. La specifica del linguaggio costituisce il riferimento ufficiale principale per la sintassi e l'uso di C#.