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

    _listOfHandlers = methodToCall;

  }

}

В приведенном примере обратите внимание на то, что типы делегатов определяются прямо внутри области действия класса Car; безусловно, это необязательно, но помогает закрепить идею о том, что делегат естественным образом работает с таким отдельным классом. Тип делегата CarEngineHandler может указывать на любой метод, который принимает значение string как параметр и имеет void в качестве возвращаемого типа.

Кроме того, была объявлена закрытая переменная-член делегата (_listOfHandlers) и вспомогательная функция (RegisterWithCarEngine()), которая позволяет вызывающему коду добавлять метод в список вызовов делегата.

На заметку! Строго говоря, переменную-член типа делегата можно было бы определить как public, избежав тем самым необходимости в создании дополнительных методов регистрации. Тем не менее, за счет определения этой переменной-члена типа делегата как private усиливается инкапсуляция и обеспечивается решение, более безопасное в отношении типов. Позже в главе при рассмотрении ключевого слова event языка C# мы еще вернемся к анализу рисков объявления переменных-членов с типами делегатов как public.

Теперь необходимо создать метод Accelerate(). Вспомните, что цель в том, чтобы позволить объекту Car отправлять связанные с двигателем сообщения любому подписавшемуся прослушивателю. Вот необходимое обновление:

// 4. Реализовать метод Accelerate() для обращения к списку

//    вызовов делегата в подходящих обстоятельствах.

public void Accelerate(int delta)

{

  /// Если этот автомобиль сломан, то отправить сообщение об этом.

  if (_carIsDead)

   {

    _listOfHandlers?.Invoke("Sorry, this car is dead...");

  }

  else

  {

    CurrentSpeed += delta;

    // Автомобиль почти сломан?

    if (10 == (MaxSpeed - CurrentSpeed))

    {

      _listOfHandlers?.Invoke("Careful buddy! Gonna blow!");

    }

    if (CurrentSpeed >= MaxSpeed)

    {

      _carIsDead = true;

    }

    else

    {

      Console.WriteLine("CurrentSpeed = {0}", CurrentSpeed);

    }

  }

}

Обратите внимание, что при попытке вызова методов, поддерживаемых переменной-членом _listOfHandlers, используется синтаксис распространения null. Причина в том, что создание таких объектов посредством вызова вспомогательного метода RegisterWithCarEngine() является задачей вызывающего кода. Если вызывающий код не вызывал RegisterWithCarEngine(), а мы попытаемся обратиться к списку вызовов делегата, то получим исключение NullReferenceException во время выполнения. Теперь, когда инфраструктура делегатов готова, внесите в файл Program.cs следующие изменения:

using System;

using CarDelegate;

Console.WriteLine("** Delegates as event enablers **\n");

// Создать объект Car.

Car c1 = new Car("SlugBug", 100, 10);

// Сообщить объекту Car, какой метод вызывать,

// когда он пожелает отправить сообщение.

c1.RegisterWithCarEngine(

  new Car.CarEngineHandler(OnCarEngineEvent));

// Увеличить скорость (это инициирует события).

Console.WriteLine("***** Speeding up *****");

for (int i = 0; i < 6; i++)

{

  c1.Accelerate(20);

}

Console.ReadLine();

// Цель для входящих сообщений.

static void OnCarEngineEvent(string msg)

{

  Console.WriteLine("\n*** Message From Car Object ***");

  Console.WriteLine("=> {0}", msg);

  Console.WriteLine("********************\n");

}