Поделиться через


field — объявления свойств с поддержкой полей

Используйте контекстное ключевое слово field, введенное в C# 14, в методе доступа к свойству для доступа к полю резервной копии, синтезированной компилятором свойства. С помощью этого синтаксиса можно определить тело get или set метод доступа и разрешить компилятору создать другой метод доступа, так как он будет автоматически реализован в свойстве.

Справочные документы по языку C# описывают последнюю выпущенную версию языка C#. Она также содержит начальную документацию по функциям в общедоступных предварительных версиях для предстоящего языкового выпуска.

Документация определяет любую функцию, впервые представленную в последних трех версиях языка или в текущих общедоступных предварительных версиях.

Подсказка

Чтобы узнать, когда функция впервые появилась в C#, ознакомьтесь со статьей об истории версий языка C#.

Добавление контекстного ключевого field слова обеспечивает гладкий путь для добавления преимуществ, таких как проверка диапазона в автоматически реализованное свойство. Эта практика показана в следующем примере:

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

Свойство можно реализовать Hours как автоматически реализованное свойство. Затем вы обнаружите, что хотите защититься от отрицательного значения. Используйте и предоставьте field проверку диапазона в методе set доступа. Не нужно объявлять поле резервного копирования вручную или предоставлять текст для get метода доступа.

Дополнительные сведения см. в статьях Свойства и Индексаторы.

Спецификация языка C#

Дополнительные сведения см. в спецификации языка C#. Спецификация языка является предписывающим источником информации о синтаксисе и использовании языка C#.