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

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

Определение расширяющих методов

Первое ограничение, связанное с расширяющими методами, состоит в том, что они должны быть определены внутри статического класса (см. главу 5), а потому каждый расширяющий метод должен объявляться с ключевым словом static. Вторая проблема в том, что все расширяющие методы помечаются как таковые посредством ключевого слова this в качестве модификатора первого (и только первого) параметра заданного метода. Параметр, помеченный с помощью this, представляет расширяемый элемент.

В целях иллюстрации создайте новый проект консольного приложения под названием ExtensionMethods. Предположим, что создается класс по имени МуExtensions, в котором определены два расширяющих метода. Первый расширяющий метод позволяет объекту любого типа взаимодействовать с новым методом DisplayDefiningAssembly(), который использует типы из пространства имен System.Reflection для отображения имени сборки, содержащей данный тип.

На заметку! API-интерфейс рефлексии формально рассматривается в главе 17. Если эта тема для вас нова, тогда просто запомните, что рефлексия позволяет исследовать структуру сборок, типов и членов типов во время выполнения.

Второй расширяющий метод по имени ReverseDigits() позволяет любому значению типа int получить новую версию самого себя с обратным порядком следования цифр. Например, если целочисленное значение 1234 вызывает ReverseDigits(), то в результате возвратится 4321. Взгляните на следующую реализацию класса (не забудьте импортировать пространство имен System.Reflection):

using System;

using System.Reflection;

namespace MyExtensionMethods

{

  static class MyExtensions

  {

    // Этот метод позволяет объекту любого типа

    // отобразить сборку, в которой он определен

    public static void DisplayDefiningAssembly(this object obj)

    {

      Console.WriteLine("{0} lives here: => {1}\n",

        obj.GetType().Name,

        Assembly.GetAssembly(obj.GetType()).GetName().Name);

    }

    // Этот метод позволяет любому целочисленному значению изменить

    // порядок следования десятичных цифр на обратный.

    // Например, для 56 возвратится 65.

    public static int ReverseDigits(this int i)

    {

      // Транслировать int в string и затем получить все его символы.

      char[] digits = i.ToString().ToCharArray();

      // Изменить порядок следования элементов массива.

      Array.Reverse(digits);

      // Поместить обратно в строку.

      string newDigits = new string(digits);

      // Возвратить модифицированную строку как int.

      return int.Parse(newDigits);

    }

  }

}

Снова обратите внимание на то, что первый параметр каждого расширяющего метода снабжен ключевым словом this, находящимся перед определением типа параметра. Первый параметр расширяющего метода всегда представляет расширяемый тип. Учитывая, что метод DisplayDefiningAssembly() был прототипирован для расширения System.Object, этот новый член теперь присутствует в каждом типе, поскольку Object является родительским для всех типов платформы .NET Core. Однако метод ReverseDigits() прототипирован для расширения только целочисленных типов, и потому если к нему обращается какое-то другое значение, то возникнет ошибка на этапе компиляции.

На заметку! Запомните, что каждый расширяющий метод может иметь множество параметров, но только первый параметр разрешено помечать посредством this. Дополнительные параметры будут трактоваться как нормальные входные параметры, применяемые методом.

Вызов расширяющих методов

Располагая созданными расширяющими методами, рассмотрим следующий код, в котором они используются с разнообразными типами из библиотек базовых классов:

using System;

using MyExtensionMethods;

Console.WriteLine("***** Fun with Extension Methods *****\n");

//  В int появилась новая отличительная черта!

int myInt = 12345678;

myInt.DisplayDefiningAssembly();

//  И в SoundPlayer!

System.Data.DataSet d = new System.Data.DataSet();

d.DisplayDefiningAssembly();

// Использовать новую функциональность int.

Console.WriteLine("Value of myInt: {0}", myInt);

Console.WriteLine("Reversed digits of myInt: {0}",

  myInt.ReverseDigits());

Console.ReadLine();

Ниже показан вывод:

***** Fun with Extension Methods *****