Язык программирования C#9 и платформа .NET5 - Троелсен Эндрю

• определение пары открытых методов доступа и изменения;

• определение открытого свойства.

Независимо от выбранного приема идея заключается в том, что хорошо инкапсулированный класс должен защищать свои данные и скрывать подробности своего функционирования от любопытных глаз из внешнего мира. Это часто называют программированием в стиле черного ящика. Преимущество такого подхода в том, что объект может свободно изменять внутреннюю реализацию любого метода. Работа существующего кода, который использует данный метод, не нарушается при условии, что параметры и возвращаемые значения методов остаются неизменными.

Инкапсуляция с использованием традиционных методов доступа и изменения

В оставшейся части главы будет построен довольно полный класс, моделирующий обычного сотрудника. Для начала создайте новый проект консольного приложения под названием EmployeeApp и добавьте в него новый файл класса по имени Employee.cs. Обновите класс Employee с применением следующего пространства имен, полей, методов и конструкторов:

using System;

namespace EmployeeApp

{

 class Employee

  {

<b>    // Поля данных.</b>

    private string _empName;

    private int _empId;

    private float _currPay;

<b>    // Конструкторы.</b>

    public Employee() {}

    public Employee(string name, int id, float pay)

    {

      _empName = name;

      _empId = id;

      _currPay = pay;

    }

<b>   // Методы.</b>

    public void GiveBonus(float amount) =&gt; _currPay += amount;

    public void DisplayStats()

    {

      Console.WriteLine(&quot;Name: {0}&quot;, _empName);  // имя сотрудника

      Console.WriteLine(&quot;ID: {0}&quot;, _empId);      // идентификационный

                                                 // номер сотрудника

      Console.WriteLine(&quot;Pay: {0}&quot;, _currPay);   // текущая выплата

    }

  }

}

Обратите внимание, что поля класса Employee в текущий момент определены с использованием ключевого слова private. Учитывая это, поля empName, empID и currPay не будут доступными напрямую через объектную переменную. Таким образом, показанная ниже логика в коде приведет к ошибкам на этапе компиляции:

Employee emp = new Employee();

(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390})

<b>// Ошибка! Невозможно напрямую обращаться к закрытым полям объекта!</b>

emp._empName = &quot;Marv&quot;;

Если нужно, чтобы внешний мир взаимодействовал с полным именем сотрудника, то традиционный подход предусматривает определение методов доступа (метод get) и изменения (метод set). Роль метода get заключается в возвращении вызывающему коду текущего значения лежащих в основе данных состояния. Метод set позволяет вызывающему коду изменять текущее значение лежащих в основе данных состояния при условии удовлетворения бизнес-правил.

В целях иллюстрации давайте инкапсулируем поле empName, для чего к существующему классу Employee необходимо добавить показанные ниже открытые методы. Обратите внимание, что метод SetName() выполняет проверку входных данных, чтобы удостовериться, что строка имеет длину 15 символов или меньше. Если это не так, тогда на консоль выводится сообщение об ошибке и происходит возврат без внесения изменений в поле empName.

На заметку! В случае класса производственного уровня проверку длины строки с именем сотрудника следовало бы предусмотреть также и внутри логики конструктора. Мы пока проигнорируем указанную деталь, но улучшим код позже, во время исследования синтаксиса свойств.

class Employee

{

  // Поля данных.

  private string _empName;

  ...

<b>  // Метод доступа (метод get).</b>

  public string GetName() =&gt; _empName;

<b>  // Метод изменения (метод set).</b>

  public void SetName(string name)

  {

    // Перед присваиванием проверить входное значение.

    if (name.Length &gt; 15)

    {

      Console.WriteLine(&quot;Error! Name length exceeds 15 characters!&quot;);

                      // Ошибка! Длина имени превышает 15 символов!

    }

    else

    {

      _empName = name;

    }

  }

}

Такой подход требует наличия двух уникально именованных методов для управления единственным элементом данных. Чтобы протестировать новые методы, модифицируйте свой код следующим образом:

Console.WriteLine(&quot;***** Fun with Encapsulation *****n&quot;);