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

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)

    {

(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390})

      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};

myInts.PrintDataAndBeep();

Console.ReadLine();

На этом исследование расширяющих методов C# завершено. Помните, что данное языковое средство полезно, когда необходимо расширить функциональность типа, но вы не хотите создавать подклассы (или не можете, если тип запечатан) в целях обеспечения полиморфизма. Как вы увидите позже, расширяющие методы играют ключевую роль в API-интерфейсах LINQ. На самом деле вы узнаете, что в API-интерфейсах LINQ одним из самых часто расширяемых элементов является класс или структура, реализующая обобщенную версию интерфейса IEnumerable.

Поддержка расширяющего метода GetEnumerator() (нововведение в версии 9.0)

До выхода версии C# 9.0 для применения оператора foreach с экземплярами класса в этом классе нужно было напрямую определять метод GetEnumerator(). Начиная с версии C# 9.0, оператор foreach исследует расширяющие методы класса и в случае, если обнаруживает метод GetEnumerator(), то использует его для получения реализации IEnumerator, относящейся к данному классу. Чтобы удостовериться в сказанном, добавьте новый проект консольного приложения по имени ForEachWithExtensionMethods и поместите в него упрощенные версии классов Car и Garage из главы 8: