Właściwości i wymiary Hitachi R M600gp2thx

• Artykuł
10/05/2022
• Czas czytania: 4 min

Właściwość to element członkowski, który zapewnia elastyczny mechanizm odczytu, zapisu lub obliczania wartości pola prywatnego. Właściwości mogą być używane tak, jakby były elementami członkowskimi danych publicznych, ale są to specjalne metody nazywane metodami dostępu. Ta funkcja umożliwia łatwy dostęp do danych i nadal pomaga promować bezpieczeństwo i elastyczność metod.

Przegląd właściwości

• Właściwości umożliwiają klasie uwidocznienie publicznego sposobu uzyskiwania i ustawiania wartości, ukrywając implementację lub kod weryfikacyjny.
• Metody dostępu do właściwości get są używane do zwracania wartości właściwości, a element dostępu do właściwości zestawu służy do przypisywania nowej wartości. W języku C# 9 lub nowszym element dostępu właściwości init jest używany do przypisywania nowej wartości tylko podczas budowy obiektów. Te metody dostępu mogą mieć różne poziomy dostępu. Aby uzyskać więcej informacji, zobacz Ograniczanie ułatwień dostępu dostępu dostępu.
• Słowo kluczowe wartości służy do definiowania wartości przypisanej przez metodę set lub init.
• Właściwości mogą być do odczytu i zapisu (mają zarówno metodę dostępu, jak get i set metodę dostępu), tylko do odczytu (mają metodę get dostępu, ale nie set mają dostępu) lub tylko do zapisu (mają metodę set dostępu, ale bez get dostępu). Właściwości tylko do zapisu są rzadkie i najczęściej używane do ograniczania dostępu do poufnych danych.
• Proste właściwości, które nie wymagają niestandardowego kodu dostępu, można zaimplementować jako definicje treści wyrażenia lub jako właściwości zaimplementowane automatycznie.

Właściwości z polami kopii zapasowej

Jeden podstawowy wzorzec implementacji właściwości obejmuje użycie prywatnego pola tworzenia kopii zapasowej do ustawiania i pobierania wartości właściwości. Metoda get dostępu zwraca wartość pola prywatnego, a set metoda dostępu może przeprowadzić weryfikację danych przed przypisaniem wartości do pola prywatnego. Obie metody dostępu mogą również wykonać konwersję lub obliczenia na danych, zanim będą przechowywane lub zwracane.

Poniższy przykład ilustruje ten wzorzec. W tym przykładzie TimePeriod klasa reprezentuje interwał czasu. Wewnętrznie klasa przechowuje interwał czasu w sekundach w polu prywatnym o nazwie _seconds. Właściwość read-write o nazwie Hours umożliwia klientowi określenie interwału czasu w godzinach. get Metody i set metody dostępu wykonują niezbędną konwersję między godzinami i sekundami. Ponadto set metoda dostępu weryfikuje ArgumentOutOfRangeException dane i zgłasza błąd, jeśli liczba godzin jest nieprawidłowa.

public class TimePeriod{private double _seconds;public double Hoursget { return _seconds / 3600;}setif (value < 0 || value > 24)throw new ArgumentOutOfRangeException(nameof(value),"The valid range is between 0 and 24. ");_seconds = value * 3600;}}}

Możesz uzyskać dostęp do właściwości w celu pobrania i ustawienia wartości, jak pokazano w poniższym przykładzie:

TimePeriod t = new TimePeriod();// The property assignment causes the 'set' accessor to be called.t. Hours = 24;// Retrieving the property causes the 'get' accessor to be called.Console. WriteLine($"Time in hours: {t. Hours}");// The example displays the following output:// Time in hours: 24
Definicje treści wyrażeń
Metody dostępu do właściwości często składają się z instrukcji jednowierszowych, które po prostu przypisują lub zwracają wynik wyrażenia. Te właściwości można zaimplementować jako elementy członkowskie wyrażeń. Definicje treści wyrażeń składają się z symbolu =>, po którym następuje wyrażenie, które ma zostać przypisane do właściwości lub pobrane z niej. 
Właściwości tylko do odczytu mogą implementować metodę get dostępu jako element członkowski wyrażenia. W takim przypadku ani get słowo kluczowe dostępu, ani słowo kluczowe nie return jest używane. Poniższy przykład implementuje właściwość tylko do Name odczytu jako element członkowski wyrażenia. 
public class Personprivate string _firstName;private string _lastName;public Person(string first, string last)_firstName = first;_lastName = last;}public string Name => $"{_firstName} {_lastName}";}
Zarówno metodę, jak i set metodę get dostępu można zaimplementować jako elementy członkowskie wyrażeń. W takim przypadku get słowa kluczowe i set muszą być obecne. Poniższy przykład ilustruje użycie definicji treści wyrażeń dla obu metod dostępu. Słowo return kluczowe nie jest używane z akcesorem get. 
public class SaleItemstring _name;decimal _cost;public SaleItem(string name, decimal cost)_name = name;_cost = cost;}public string Nameget => _name;set => _name = value;}public decimal Priceget => _cost;set => _cost = value;}}
Właściwości zaimplementowane automatycznie
W niektórych przypadkach właściwość get i set metody dostępu przypisują wartość do pola zaplecza lub pobierają wartość bez uwzględniania dodatkowej logiki. Korzystając z właściwości zaimplementowanych automatycznie, można uprościć kod, gdy kompilator języka C# w przezroczysty sposób udostępnia pole tworzenia kopii zapasowej. 
Jeśli właściwość ma zarówno metodę dostępu a get, jak i set (lub get i init), oba muszą zostać zaimplementowane automatycznie. Właściwość implementowana automatycznie jest definiowana przy użyciu get słów kluczowych i set bez podawania żadnej implementacji. Poniższy przykład powtarza poprzedni, z tą różnicą, że Name i Price są automatycznie implementowane właściwości. W przykładzie usunięto również sparametryzowany konstruktor, aby SaleItem obiekty zostały zainicjowane za pomocą wywołania konstruktora bez parametrów i inicjatora obiektu. 
{ get; set;}{ get; set;}}
Właściwości zaimplementowane automatycznie mogą deklarować różne możliwości dostępu dla get metod i set. Powszechnie deklarujesz publiczne get akcesorium i prywatne set akcesorium. Więcej informacji można dowiedzieć się w artykule dotyczącym ograniczania ułatwień dostępu dostępu dostępu. 
Wymagane właściwości
Począwszy od języka C# 11, można dodać required element członkowski, aby wymusić zainicjowanie dowolnej właściwości lub pola klienta:
public required string Namepublic required decimal Price
Aby utworzyć obiekt SaleItem, należy ustawić właściwości Name i Price przy użyciu inicjatorów obiektów, jak pokazano w poniższym kodzie:
var item = new SaleItem { Name = "Shoes", Price = 19. 95m};Console. WriteLine($"{item. Name}: sells for {item. Price:C2}");
Używanie właściwości
Właściwości interfejsu
Porównanie właściwości i indeksatorów
Ograniczanie dostępności metody dostępu
Właściwości zaimplementowane automatycznie
Specyfikacja języka C#
Aby uzyskać więcej informacji, zobacz Właściwości w specyfikacji języka C#. Specyfikacja języka jest ostatecznym źródłem informacji o składni i użyciu języka C#. 
Zobacz też
Indexers (Indeksatory)
pobierz słowo kluczowe
ustaw słowo kluczowe