field - Deklarace vlastností založené na polích

Důležité

Klíčové field slovo je funkce preview v jazyce C# 13. Pokud chcete použít field kontextové klíčové slovo, musíte použít .NET 9 a nastavit prvek <LangVersion> do preview souboru projektu.

Měli byste být opatrní pomocí funkce klíčového field slova ve třídě, která má pole s názvem field. Nové field klíčové slovo stínuje pole pojmenované field v oboru přístupového objektu vlastnosti. Můžete změnit název field proměnné nebo pomocí @ tokenu odkazovat na field identifikátor jako @field. Další informace najdete ve specifikaci funkce pro field klíčové slovo.

Kontextové klíčové slovo field, přidané jako funkce preview v jazyce C# 13, lze použít v přistupující vlastnosti pro přístup k kompilátoru syntetizované backing pole vlastnosti. Tato syntaxe umožňuje definovat tělo objektu get nebo set přístupového objektu a nechat kompilátoru vygenerovat další přístupové objekty tak, jak by to bylo v automaticky implementované vlastnosti.

Přidání kontextových field klíčových slov poskytuje plynulou cestu pro přidání výhod, jako je kontrola rozsahu do automaticky implementované vlastnosti. Tento postup je znázorněn v následujícím příkladu:

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

Vlastnost můžete implementovat Hours jako automaticky implementovanou vlastnost. Pak zjistíte, že chcete chránit před zápornou hodnotou. Používáte field a poskytujete kontrolu rozsahu v přístupovém objektu set . Není nutné deklarovat zadní pole ručně a poskytnout tělo pro get příslušenství.

Další informace najdete v článcích o vlastnostech a indexerech .

specifikace jazyka C#

Další informace najdete v tématu Specifikace jazyka C#. Specifikace jazyka je úplným a rozhodujícím zdrojem pro syntaxi a použití jazyka C#.