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

  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 *****
 Int32 lives here: => System.Private.CoreLib
 DataSet lives here: => System.Data.Common
 Value of myInt: 12345678
 Reversed digits of myInt: 87654321

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

Когда определяется класс, содержащий расширяющие методы, он вне всяких сомнений будет принадлежать какому-то пространству имен. Если это пространство имен отличается от пространства имен, где расширяющие методы применяются, тогда придется использовать ключевое слово using языка С#, которое позволит файлу кода иметь доступ ко всем расширяющим методам интересующего типа. Об этом важно помнить, потому что если явно не импортировать корректное пространство имен, то в таком файле кода C# расширяющие методы будут недоступными.

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

 namespace MyExtensionMethods
 {
  static class MyExtensions
  {
  ...
  }
 }

Для использования расширяющих методов класса MyExtensions необходимо явно импортировать пространство имен MyExtensionMethods, как делалось в рассмотренных ранее примерах операторов верхнего уровня.

Расширение типов, реализующих специфичные интерфейсы

К настоящему моменту вы видели, как расширять классы (и косвенно структуры, которые следуют тому же синтаксису) новой функциональностью через расширяющие методы. Также есть возможность определить расширяющий метод, который способен расширять только класс или структуру, реализующую корректный интерфейс. Например, можно было бы заявить следующее: если класс или структура реализует интерфейс IEnumerable<T>, тогда этот тип получит новые члены. Разумеется, вполне допустимо требовать, чтобы тип поддерживал вообще любой интерфейс, включая ваши специальные интерфейсы.

В качестве примера создайте новый проект консольного приложения по имени InterfaceExtensions. Цель здесь заключается в том, чтобы добавить новый метод к любому типу, который реализует интерфейс IEnumerable, что охватывает все массивы и многие классы необобщенных коллекций (вспомните из главы 10, что обобщенный интерфейс IEnumerable<T> расширяет необобщенный интерфейс IEnumerable). Добавьте к проекту следующий расширяющий класс:

 using System;
 namespace InterfaceExtensions
 {
  static class AnnoyingExtensions
  {
  public static void PrintDataAndBeep(
  this System.Collections.IEnumerable iterator)
  {
  foreach (var item in iterator)
  {
  Console.WriteLine(item);
  Console.Beep;
  }
  }
  }
 }

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

 using System;
 using System.Collections.Generic;
 using InterfaceExtensions;

 Console.WriteLine("***** Extending Interface Compatible Types *****\n");

 // System.Array реализует IEnumerable!
 string[] data =
  { "Wow", "this", "is", "sort", "of", "annoying",
  "but", "in", "a", "weird", "way", "fun!"};
 data.PrintDataAndBeep;

 Console.WriteLine;

 // List<T> реализует IEnumerable!
 List<int> myInts = new List<int> {10, 15, 20};