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

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

Первое ограничение, связанное с расширяющими методами, состоит в том, что они должны быть определены внутри статического класса (см. главу 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)

{

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

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)

{

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

// Транслировать 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 *****

Выбрать книгу по жанру

Фантастика и фэнтези

Детективы и триллеры

Проза

Любовные романы

Приключения

Детские

Поэзия и драматургия

Старинная литература

Научно-образовательная

Компьютеры и интернет

Справочная литература

Документальная литература

Религия и духовность

Юмор

Дом и семья

Деловая литература

Жанр не определен

Техника

Прочее

Драматургия

Фольклор

Военное дело

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