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

внимание, что мы не создаем напрямую ассоциированный объект делегата, а просто указываем метод, который соответствует ожидаемой сигнатуре делегата (в данном случае метод, возвращающий void и принимающий единственный аргумент string). Имейте в виду, что компилятор C# по-прежнему обеспечивает безопасность в отношении типов. Таким образом, если метод OnCarEngineEvent() не принимает string и не возвращает void, тогда возникнет ошибка на этапе компиляции.

Понятие обобщенных делегатов

В главе 10 упоминалось о том, что язык C# позволяет определять обобщенные типы делегатов. Например, предположим, что необходимо определить тип делегата, который может вызывать любой метод, возвращающий void и принимающий единственный параметр. Если передаваемый аргумент может изменяться, то это легко смоделировать с использованием параметра типа. Взгляните на следующий код внутри нового проекта консольного приложения по имени GenericDelegate:

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

// Зарегистрировать цели.

MyGenericDelegate<string> strTarget =

  new MyGenericDelegate<string>(StringTarget);

strTarget("Some string data");

// Использовать синтаксис группового преобразования методов

MyGenericDelegate<int> intTarget = IntTarget;

intTarget(9);

Console.ReadLine();

static void StringTarget(string arg)

{

  Console.WriteLine("arg in uppercase is: {0}", arg.ToUpper());

}

static void IntTarget(int arg)

{

  Console.WriteLine("++arg is: {0}", ++arg);

}

// Этот обобщенный делегат может вызывать любой метод, который

// возвращает void и принимает единственный параметр типа Т.

public delegate void MyGenericDelegate<T>(T arg);

Как видите, в типе делегата MyGenericDelegate<T> определен единственный параметр, представляющий аргумент для передачи цели делегата. При создании экземпляра этого типа должно быть указано значение параметра типа наряду с именем метода, который делегат может вызывать. Таким образом, если указать тип string, тогда целевому методу будет отправляться строковое значение:

// Создать экземпляр MyGenericDelegate<T>

// с указанием string в качестве параметра типа.

MyGenericDelegate<string> strTarget = StringTarget;

strTarget("Some string data");

С учетом формата объекта strTarget метод StringTarget теперь должен принимать в качестве параметра единственную строку:

static void StringTarget(string arg)

{

  Console.WriteLine(

    "arg in uppercase is: {0}", arg.ToUpper());

}

Обобщенные делегаты Action<> и Func<>

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

1. Определить специальный делегат, соответствующий формату метода, на который он указывает.

2. Создать экземпляр специального делегата, передав имя метода в качестве аргумента конструктора.

3. Косвенно обратиться к методу через вызов Invoke() на объекте делегата.

В случае принятия такого подхода в итоге, как правило, получается несколько специальных делегатов, которые могут никогда не использоваться за рамками текущей задачи (например, MyGenericDelegate<T>, CarEngineHandler и т.д.). Хотя вполне может быть и так, что для проекта требуется специальный уникально именованный делегат, в других ситуациях точное имя типа делегата роли не играет. Во многих случаях просто необходим "какой-нибудь делегат", который принимает набор аргументов и возможно возвращает значение, отличное от void. В таких ситуациях можно применять встроенные в инфраструктуру делегаты Action<> и Func<>. Чтобы удостовериться в их полезности, создайте новый проект консольного приложения по имени ActionAndFuncDelegates.

Обобщенный делегат Action<> определен в пространствах имен System. Его можно использовать для "указания" на метод, который принимает вплоть до 16 аргументов (чего должно быть вполне достаточно!) и возвращает void. Вспомните, что поскольку Action<> является обобщенным делегатом, понадобится также указывать типы всех параметров.

Модифицируйте класс Program, определив в нем новый статический метод, который принимает (скажем) три уникальных параметра:

// Это цель для делегата Action<>.

static void DisplayMessage(string msg, ConsoleColor txtColor,

                           int printCount)

{

  // Установить цвет текста консоли.

  ConsoleColor previous = Console.ForegroundColor;

  Console.ForegroundColor = txtColor;

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

  {

    Console.WriteLine(msg);

  }

  // Восстановить цвет.

  Console.ForegroundColor = previous;

}

Теперь вместо построения специального делегата вручную для передачи потока программы методу DisplayMessage() вы можете применять готовый делегат Action<>:

Console.WriteLine("***** Fun with Action and Func *****");

// Использовать делегат Action<> для указания на метод DisplayMessage().

Action<string, ConsoleColor, int> actionTarget =

  DisplayMessage;

actionTarget("Action Message!", ConsoleColor.Yellow, 5);

Console.ReadLine();

Как видите, при использовании делегата Action<> не нужно беспокоиться об определении специального типа делегата. Тем не менее, как уже упоминалось, тип делегата Action<> позволяет указывать только на методы, возвращающие void. Если необходимо указывать на метод, имеющий возвращаемое значение (и нет желания заниматься написанием собственного типа делегата), тогда можно применять тип делегата Func<>.

Обобщенный делегат Funс<> способен указывать на методы, которые (подобно Action<>) принимают вплоть до 16 параметров и имеют специальное возвращаемое значение. В целях иллюстрации добавьте в класс Program новый метод:

// Цель для делегата Func<>.

static int Add(int x, int y)

{

  return x + y;

}

Ранее в главе был построен специальный делегат BinaryOp для "указания" на методы сложения и вычитания. Теперь задачу можно упростить за счет использования версии Func<>, которая принимает всего три параметра типа. Учтите, что последний параметр в Func<> всегда представляет возвращаемое значение метода. Чтобы закрепить данный момент, предположим, что в классе Program также определен следующий метод:

static string SumToString(int x, int y)

{

  return (x + y).ToString();

}

Вызовите эти методы:

Func<int, int, int> funcTarget = Add;

int result = funcTarget.Invoke(40, 40);

Console.WriteLine("40 + 40 = {0}", result);

Func<int, int, string> funcTarget2 = SumToString;

string sum = funcTarget2(90, 300);

Console.WriteLine(sum);

С учетом того, что делегаты Action<> и Func<> могут устранить шаг по ручному определению специального делегата, вас может интересовать, должны ли они применяться всегда. Подобно большинству аспектов программирования ответ таков: в зависимости от ситуации. Во многих случаях Action<> и Func<> будут предпочтительным вариантом. Однако если необходим делегат со специальным именем, которое, как вам кажется, помогает лучше отразить предметную область, то