Udostępnij przez


field - Deklaracje właściwości z kopią zapasową pola

Użyj kontekstowego słowa kluczowego field, wprowadzonego w języku C# 14, w metodzie dostępu do właściwości, aby uzyskać dostęp do pola zapasowego syntetyzowanego kompilatora właściwości. Korzystając z tej składni, można zdefiniować treść metody get lub set metody dostępu i pozwolić kompilatorowi wygenerować inne metody dostępu, tak jak w przypadku automatycznie zaimplementowanej właściwości.

Dokumentacja języka C# zawiera ostatnio wydaną wersję języka C#. Zawiera również początkową dokumentację dla funkcjonalności w publicznych wersjach testowych nadchodzącego wydania języka.

Dokumentacja identyfikuje dowolną funkcję po raz pierwszy wprowadzoną w ostatnich trzech wersjach języka lub w bieżącej publicznej wersji zapoznawczej.

Wskazówka

Aby dowiedzieć się, kiedy funkcja została po raz pierwszy wprowadzona w języku C#, zapoznaj się z artykułem dotyczącym historii wersji języka C#.

Dodanie słowa kluczowego field kontekstowego zapewnia płynną ścieżkę do dodawania korzyści, takich jak sprawdzanie zakresu do automatycznie zaimplementowanej właściwości. Ta praktyka jest pokazana w poniższym przykładzie:

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

Właściwość można zaimplementować Hours jako automatycznie zaimplementowaną właściwość. Następnie odkryjesz, że chcesz chronić przed wartością ujemną. Użyj field i zapewnij sprawdzanie zakresu w metodzie set dostępu. Nie musisz deklarować pola zaplecza ręcznie ani podać ciało dla akcesorium get .

Aby uzyskać więcej informacji, zobacz artykuły Właściwości i indeksatory .

specyfikacja języka C#

Aby uzyskać więcej informacji, zobacz Specyfikacja języka C#. Specyfikacja języka jest ostatecznym źródłem informacji o składni i użyciu języka C#.