Klíčové slovo set (Referenční dokumentace jazyka C#)

Klíčové set slovo definuje metodu přístupového objektu ve vlastnosti nebo indexeru, která přiřadí hodnotu vlastnosti nebo prvku indexeru. Další informace a příklady naleznete v tématu Vlastnosti, Automaticky implementované vlastnosti a Indexery.

Referenční dokumentace jazyka C# dokumentuje naposledy vydané verze jazyka C#. Obsahuje také počáteční dokumentaci k funkcím ve verzi Public Preview pro nadcházející jazykovou verzi.

Dokumentace identifikuje všechny funkce, které byly poprvé představeny v posledních třech verzích jazyka nebo v aktuálních verzích Public Preview.

Návod

Informace o tom, kdy byla funkce poprvé představena v jazyce C#, najdete v článku o historii verzí jazyka C#.

V jednoduchých případech, kdy objekty get a set přístupové objekty neprovádějí žádnou jinou operaci než nastavení nebo načítání hodnoty v privátním backingovém poli, použijte automaticky implementované vlastnosti. Následující příklad implementuje Hours jako automaticky implementovanou vlastnost.

class TimePeriod3
{
    public double Hours { get; set; }
}

Důležité

Nelze použít automaticky implementované vlastnosti pro deklarace vlastností rozhraní ani pro implementovanou deklaraci částečné vlastnosti. Kompilátor interpretuje syntaxi odpovídající automaticky implementované vlastnosti jako deklarující deklaraci, nikoli implementační deklaraci.

Možná budete muset implementovat jedno z těl příslušenství. Klíčové field slovo přidané v jazyce C# 14 deklaruje vlastnost zazálohované polem. Pomocí vlastnosti zálohované pole nechte kompilátoru vygenerovat jeden přístup, zatímco píšete ručně. field Použijte klíčové slovo pro přístup k syntetizovanému záložnímu poli kompilátoru:

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

Přistupování set se často skládá z jednoho příkazu, který přiřazuje hodnotu, jak tomu bylo v předchozím příkladu. Přístupové objekty můžete implementovat set jako člen s výrazem. Následující příklad implementuje jak get objekty, tak set přístupové objekty jako členy s body výrazu.

class TimePeriod2
{
    private double _seconds;

    public double Seconds
    {
        get => _seconds;
        set => _seconds = value;
    }
}

Následující příklad definuje jak a getset příslušenství pro vlastnost s názvem Seconds. Používá soukromé pole pojmenované _seconds k vrácení hodnoty vlastnosti.

class TimePeriod
{
    private double _seconds;

    public double Seconds
    {
        get { return _seconds; }
        set
        {
            if (value < 0)
            {
                throw new ArgumentOutOfRangeException(nameof(value), "The value of the time period must be non-negative.");
            }
            _seconds = value;
        }
    }
}

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#.

Viz také

• Vlastnosti