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

=> Careful buddy! Gonna blow!

***********************************

CurrentSpeed = 90

***** Message From Car Object *****

=> Sorry, this car is dead...

***********************************

Включение группового вызова

Вспомните, что делегаты .NET Core обладают встроенной возможностью группового вызова. Другими словами, объект делегата может поддерживать целый список методов для вызова, а не просто единственный метод. Для добавления нескольких методов к объекту делегата вместо прямого присваивания применяется перегруженная операция +=. Чтобы включить групповой вызов в классе Car, можно модифицировать метод RegisterWithCarEngine():

public class Car

{

  // Добавление поддержки группового вызова.

  // Обратите внимание на использование операции +=,

  // а не обычной операции присваивания (=).

  public void RegisterWithCarEngine(

    CarEngineHandler methodToCall)

  {

    _listOfHandlers += methodToCall;

  }

  ...

}

Когда операция += используется с объектом делегата, компилятор преобразует ее в вызов статического метода Delegate.Combine(). На самом деле можно было бы вызывать Delegate.Combine() напрямую, однако операция += предлагает более простую альтернативу. Хотя нет никакой необходимости в модификации текущего метода RegisterWithCarEngine(), ниже представлен пример применения Delegate.Combine() вместо операции +=:

public void RegisterWithCarEngine( CarEngineHandler methodToCall )

{

  if (_listOfHandlers == null)

  {

    _listOfHandlers = methodToCall;

  }

  else

  {

    _listOfHandlers =

      Delegate.Combine(_listOfHandlers, methodToCall)

        as CarEngineHandler;

  }

}

В любом случае вызывающий код теперь может регистрировать множественные цели для одного и того же обратного вызова. Второй обработчик выводит входное сообщение в верхнем регистре просто ради отображения:

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

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

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

// Зарегистрировать несколько обработчиков событий.

c1.RegisterWithCarEngine(

  new Car.CarEngineHandler(OnCarEngineEvent));

c1.RegisterWithCarEngine(

  new Car.CarEngineHandler(OnCarEngineEvent2));

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

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

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

{

  c1.Accelerate(20);

}

Console.ReadLine();

// Теперь есть ДВА метода, которые будут

// вызываться Car при отправке уведомлений.

static void OnCarEngineEvent(string msg)

{

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

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

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

}

static void OnCarEngineEvent2(string msg)

{

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

}

Удаление целей из списка вызовов делегата

В классе Delegate также определен статический метод Remove(), который позволяет вызывающему коду динамически удалять отдельные методы из списка вызовов объекта делегата. В итоге у вызывающего кода появляется возможность легко "отменять подписку" на заданное уведомление во время выполнения. Хотя метод Delegate.Remove() допускается вызывать в коде напрямую, разработчики C# могут использовать в качестве удобного сокращения операцию -=. Давайте добавим в класс Car новый метод, который позволяет вызывающему коду исключать метод из списка вызовов:

public class Car

{

  ...

  public void UnRegisterWithCarEngine(CarEngineHandler methodToCall)

  {

    _listOfHandlers -= methodToCall;

  }

}

При таком обновлении класса Car прекратить получение уведомлений от второго обработчика можно за счет изменения вызывающего кода следующим образом:

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

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

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

c1.RegisterWithCarEngine(

  new Car.CarEngineHandler(OnCarEngineEvent));

// На этот раз сохранить объект делегата, чтобы позже

// можно было отменить регистрацию.

Car.CarEngineHandler handler2 =

  new Car.CarEngineHandler(OnCarEngineEvent2);

c1.RegisterWithCarEngine(handler2);

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

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

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

{

  c1.Accelerate(20);

}

// Отменить регистрацию второго обработчика.

c1.UnRegisterWithCarEngine(handler2);

// Сообщения в верхнем регистре больше не выводятся.

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

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

{

  c1.Accelerate(20);

}

Console.ReadLine();

Отличие этого кода в том, что здесь создается объект Car.CarEngineHandler, который сохраняется в локальной переменной, чтобы впоследствии можно было отменить подписку на получение уведомлений. Таким образом, при увеличении скорости объекта Car во второй раз версия входного сообщения в верхнем регистре больше выводиться не будет, поскольку данная цель исключена из списка вызовов делегата.

Синтаксис групповых преобразований методов

 В предыдущем примере CarDelegate явно создавались экземпляры класса делегата Car.CarEngineHandler для регистрации и отмены регистрации на получение уведомлений:

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

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

c1.RegisterWithCarEngine(new Car.CarEngineHandler(OnCarEngineEvent));

Car.CarEngineHandler handler2 =

  new Car.CarEngineHandler(OnCarEngineEvent2);

c1.RegisterWithCarEngine(handler2);

...

Конечно, если необходимо вызывать любые унаследованные члены класса MulticastDelegate или Delegate, то проще всего вручную создать переменную делегата. Однако в большинстве случаев иметь дело с внутренним устройством объекта делегата не требуется. Объект делегата обычно придется применять только для передачи имени метода в параметре конструктора.

Для простоты в языке C# предлагается сокращение, называемое групповым преобразованием методов. Это средство позволяет указывать вместо объекта делегата прямое имя метода, когда вызываются методы, которые принимают делегаты в качестве аргументов.

На заметку! Позже в главе вы увидите, что синтаксис группового преобразования методов можно также использовать для упрощения регистрации событий С#.

В целях иллюстрации внесите в файл Program.cs показанные ниже изменения, где групповое преобразование методов применяется для регистрации и отмены регистрации подписки на уведомления:

...

Console.WriteLine("***** Method Group Conversion *****n");

Car c2 = new Car();

// Зарегистрировать простое имя метода.

c2.RegisterWithCarEngine(OnCarEngineEvent);

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

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

{

  c2.Accelerate(20);

}

// Отменить регистрацию простого имени метода.

c2.UnRegisterWithCarEngine(OnCarEngineEvent);

// Уведомления больше не поступают!

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

{

  c2.Accelerate(20);

}

Console.ReadLine();

Обратите