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

class="p1">    Console.WriteLine("Name: {0} {1}",

                       myPeople[i].FirstName, myPeople[i].LastName);

    Console.WriteLine("Age: {0}", myPeople[i].Age);

    Console.WriteLine();

  }

}

Индексация данных с использованием строковых значений

В текущей версии класса PersonCollection определен индексатор, позволяющий вызывающему коду идентифицировать элементы с применением числовых значений. Однако вы должны понимать, что это не требование индексаторного метода. Предположим, что вы предпочитаете хранить объекты Person, используя тип System.Collections.Generic.Dictionary<TKey,TValue>, а не ArrayList. Поскольку типы Dictionary разрешают доступ к содержащимся внутри них элементам с применением ключа (такого как фамилия лица), индексатор можно было бы определить следующим образом:

using System.Collections;

using System.Collections.Generic;

namespace SimpleIndexer

{

  public class PersonCollectionStringIndexer : IEnumerable

  {

    private Dictionary<string, Person> listPeople =

        new Dictionary<string, Person>();

    // Этот индексатор возвращает объект лица на основе строкового индекса.

    public Person this[string name]

    {

      get => (Person)listPeople[name];

      set => listPeople[name] = value;

    }

    public void ClearPeople()

    {

      listPeople.Clear();

    }

    public int Count => listPeople.Count;

    IEnumerator IEnumerable.GetEnumerator() => listPeople.GetEnumerator();

  }

}

Теперь вызывающий код способен взаимодействовать с содержащимися внутри объектами Person:

Console.WriteLine("***** Fun with Indexers *****n");

PersonCollectionStringIndexer myPeopleStrings =

  new PersonCollectionStringIndexer();

myPeopleStrings["Homer"] =

  new Person("Homer", "Simpson", 40);

myPeopleStrings["Marge"] =

  new Person("Marge", "Simpson", 38);

// Получить объект лица Homer и вывести данные.

Person homer = myPeopleStrings["Homer"];

Console.ReadLine();

И снова, если бы обобщенный тип Dictionary<TKey, TValue>, напрямую, то функциональность индексаторного метода была бы получена в готовом виде без построения специального необобщенного класса, поддерживающего строковый индексатор. Тем не менее, имейте в виду, что тип данных любого индексатора будет основан на том, как поддерживающий тип коллекции позволяет вызывающему коду извлекать элементы.

Перегрузка индексаторных методов

Индексаторные методы могут быть перегружены в отдельном классе или структуре. Таким образом, если имеет смысл предоставить вызывающему коду возможность доступа к элементам с применением числового индекса или строкового значения, то в одном типе можно определить несколько индексаторов. Например, в ADO.NET (встроенный API-интерфейс .NET для доступа к базам данных) класс DataSet поддерживает свойство по имени Tables, которое возвращает строго типизированную коллекцию DataTableCollection. В свою очередь тип DataTableCollection определяет три индексатора для получения и установки объектов DataTable — по порядковой позиции, по дружественному строковому имени и по строковому имени с дополнительным пространством имен:

public sealed class DataTableCollection : InternalDataCollectionBase

{

...

  // Перегруженные индексаторы.

  public DataTable this[int index] { get; }

  public DataTable this[string name] { get; }

  public DataTable this[string name, string tableNamespace] { get; }

}

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

Многомерные индексаторы

Допускается также создавать индексаторный метод, который принимает несколько параметров. Предположим, что есть специальная коллекция, хранящая элементы в двумерном массиве. В таком случае индексаторный метод можно определить следующим образом:

public class SomeContainer

{

  private int[,] my2DintArray = new int[10, 10];

  public int this[int row, int column]

  {  /* получить или установить значение в двумерном массиве */  }

}

Если только вы не строите высокоспециализированный класс коллекций, то вряд ли будете особо нуждаться в создании многомерного индексатора. Пример ADO.NET еще раз демонстрирует, насколько полезной может оказаться такая конструкция. Класс DataTable в ADO.NET по существу представляет собой коллекцию строк и столбцов, похожую на миллиметровку или на общую структуру электронной таблицы Microsoft Excel.

Хотя объекты DataTable обычно наполняются без вашего участия с использованием связанного "адаптера данных", в приведенном ниже коде показано, как вручную создать находящийся в памяти объект DataTable, который содержит три столбца (для имени, фамилии и возраста каждой записи). Обратите внимание на то, как после добавления одной строки в DataTable с помощью многомерного индексатора производится обращение ко всем столбцам первой (и единственной) строки. (Если вы собираетесь следовать примеру, тогда импортируйте в файл кода пространство имен System.Data.)

static void MultiIndexerWithDataTable()

{

  // Создать простой объект DataTable с тремя столбцами.

  DataTable myTable = new DataTable();

  myTable.Columns.Add(new DataColumn("FirstName"));

   myTable.Columns.Add(new DataColumn("LastName"));

  myTable.Columns.Add(new DataColumn("Age"));

  // Добавить строку в таблицу.

  myTable.Rows.Add("Mel", "Appleby", 60);

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

  Console.WriteLine("First Name: {0}", myTable.Rows[0][0]);

  Console.WriteLine("Last Name: {0}", myTable.Rows[0][1]);

  Console.WriteLine("Age : {0}", myTable.Rows[0][2]);

}

Начиная с главы 21, мы продолжим рассмотрение ADO.NET, так что не переживайте, если что-то в приведенном выше коде выглядит незнакомым. Пример просто иллюстрирует, что индексаторные методы способны поддерживать множество измерений, а при правильном применении могут упростить взаимодействие с объектами, содержащимися в специальных коллекциях.

Определения индексаторов в интерфейсных типах

 Индексаторы могут определяться в выбранном типе интерфейса .NET Core, чтобы позволить поддерживающим типам предоставлять специальные реализации. Ниже показан простой пример интерфейса, который задает протокол для получения строковых объектов с использованием числового индексатора:

public interface IStringContainer

{

  string this[int index] { get; set; }

}

При таком определении интерфейса любой класс или структура, которые его реализуют, должны поддерживать индексатор с чтением/записью, манипулирующий элементами с применением числового значения. Вот частичная реализация класса подобного вида:

class SomeClass : IStringContainer

{

  private List<string> myStrings = new List<string>();

  public string this[int index]

  {

    get => myStrings[index];

    set => myStrings.Insert(index, value);

  }

}

На этом первая крупная тема настоящей главы завершена. А теперь давайте перейдем к исследованиям языкового средства, которое позволяет строить специальные классы и структуры, уникальным образом реагирующие на