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

Новые члены для представления имени водителя.

  public string name;

  public void SetDriverName(string name) => name = name;

...

}

Хотя приведенный код нормально скомпилируется, компилятор C# выдаст сообщение с предупреждением о том, что переменная присваивается сама себе! В целях иллюстрации добавьте в свой код вызов метода SetDriverName() и обеспечьте вывод значения поля name. Вы можете быть удивлены, обнаружив, что значением поля name является пустая строка!

// Создать объект Motorcycle с мотоциклистом по имени Tiny?

Motorcycle c = new Motorcycle(5);

c.SetDriverName("Tiny");

c.PopAWheely();

Console.WriteLine("Rider name is {0}", c.name);  // Выводит пустое значение name!

Проблема в том, что реализация метода SetDriverName() присваивает входному параметру значение его самого, т.к. компилятор предполагает, что name ссылается на переменную, находящуюся в области видимости метода, а не на поле name из области видимости класса. Для информирования компилятора о том, что необходимо установить поле данных name текущего объекта в значение входного параметра name, просто используйте ключевое слово this, устранив такую неоднозначность:

public void SetDriverName(string name) => this.name = name;

Если неоднозначность отсутствует, тогда применять ключевое слово this для доступа класса к собственным полям данных или членам вовсе не обязательно. Например, если вы переименуете член данных типа string с name на driverName (что также повлечет за собой модификацию операторов верхнего уровня), то потребность в использовании this отпадет, поскольку неоднозначности с областью видимости больше нет:

class Motorcycle

{

  public int driverIntensity;

  public string driverName;

  public void SetDriverName(string name)

  {

    // These two statements are functionally the same.

    driverName = name;

    this.driverName = name;

  }

...

}

Несмотря на то что применение ключевого слова this в неоднозначных ситуациях дает не особенно большой выигрыш, вы можете счесть его удобным при реализации членов класса, т.к. IDE-среды, подобные Visual Studio и Visual Studio Code, будут активизировать средство IntelliSense, когда присутствует this. Это может оказаться полезным, если вы забыли имя члена класса и хотите быстро вспомнить его определение.

На заметку! Общепринятое соглашение об именовании предусматривает снабжение имен закрытых (или внутренних) переменных уровня класса префиксом в виде символа подчеркивания (скажем, _driverName), чтобы средство IntelliSense отображало все ваши переменные в верхней части списка. В нашем простом примере все поля являются открытыми, поэтому такое соглашение об именовании не применяется. В остальном материале книги закрытые и внутренние переменные будут именоваться с ведущим символом подчеркивания.

Построение цепочки вызовов конструкторов с использованием this

Еще один сценарий применения ключевого слова this касается проектирования класса с использованием приема, который называется построением цепочки конструкторов. Такой паттерн проектирования полезен при наличии класса, определяющего множество конструкторов. Учитывая тот факт, что конструкторы нередко проверяют входные аргументы на предмет соблюдения разнообразных бизнес-правил, довольно часто внутри набора конструкторов обнаруживается избыточная логика проверки достоверности. Рассмотрим следующее модифицированное определение класса Motorcycle:

class Motorcycle

{

  public int driverIntensity;

  public string driverName;

  public Motorcycle() { }

  // Избыточная логика конструктора!

  public Motorcycle(int intensity)

  {

    if (intensity > 10)

    {

  intensity = 10;

    }

    driverIntensity = intensity;

  }

  public Motorcycle(int intensity, string name)

  {

    if (intensity > 10)

    {

      intensity = 10;

    }

    driverIntensity = intensity;

    driverName = name;

  }

...

}

Здесь (возможно в попытке обеспечить безопасность мотоциклиста) внутри каждого конструктора производится проверка того, что уровень мощности не превышает значения 10. Наряду с тем, что это правильно, в двух конструкторах присутствует избыточный код. Подход далек от идеала, поскольку в случае изменения правил (например, если уровень мощности не должен превышать значение 5 вместо 10) код придется модифицировать в нескольких местах.

Один из способов улучшить создавшуюся ситуацию предусматривает определение в классе Motorcycle метода, который будет выполнять проверку входных аргументов. Если вы решите поступить так, тогда каждый конструктор сможет вызывать такой метод перед присваиванием значений полям. Хотя описанный подход позволяет изолировать код, который придется обновлять при изменении бизнес-правил, теперь появилась другая избыточность:

class Motorcycle

{

   public int driverIntensity;

   public string driverName;

   // Конструкторы.

   public Motorcycle() { }

   public Motorcycle(int intensity)

   {

     SetIntensity(intensity);

   }

   public Motorcycle(int intensity, string name)

   {

     SetIntensity(intensity);

     driverName = name;

   }

   public void SetIntensity(int intensity)

   {

     if (intensity > 10)

     {

       intensity = 10;

     }

   driverIntensity = intensity;

   }

...

}

Более совершенный подход предполагает назначение конструктора, который принимает наибольшее количество аргументов, в качестве "главного конструктора" и выполнение требуемой логики проверки достоверности внутри его реализации. Остальные конструкторы могут применять ключевое слово this для передачи входных аргументов главному конструктору и при необходимости предоставлять любые дополнительные параметры. В таком случае вам придется беспокоиться только о поддержке единственного конструктора для всего класса, в то время как оставшиеся конструкторы будут в основном пустыми.

Ниже представлена финальная реализация класса Motorcycle (с одним дополнительным конструктором в целях иллюстрации). При связывании конструкторов в цепочку обратите внимание, что ключевое слово this располагается за пределами самого конструктора и отделяется от его объявления двоеточием:

class Motorcycle

{

   public int driverIntensity;

   public string driverName;

   // Связывание конструкторов в цепочку.

   public Motorcycle() {}

   public Motorcycle(int intensity)

     : this(intensity, "") {}

   public Motorcycle(string name)

     : this(0, name) {}

   // Это 'главный' конструктор, выполняющий всю реальную работу.

   public Motorcycle(int intensity, string name)

   {

     if (intensity > 10)

     {