Индексаторы в интерфейсах (Руководство по программированию в C#)

  • Статья

Индексаторы можно объявлять для интерфейса. Методы доступа индексаторов интерфейса отличаются от методов доступа индексаторов класса следующим образом:

  • Методы доступа интерфейса не используют модификаторы.
  • Метод доступа интерфейса обычно не имеет тела.

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

Ниже показан пример метода доступа индексатора для интерфейса:

public interface ISomeInterface
{
    //...

    // Indexer declaration:
    string this[int index]
    {
        get;
        set;
    }
}

Сигнатура индексатора должна отличаться от сигнатур любых других индексаторов, объявленных в том же интерфейсе.

Пример

Следующий пример демонстрирует реализацию индексаторов интерфейса.

// Indexer on an interface:
public interface IIndexInterface
{
    // Indexer declaration:
    int this[int index]
    {
        get;
        set;
    }
}

// Implementing the interface.
class IndexerClass : IIndexInterface
{
    private int[] arr = new int[100];
    public int this[int index]   // indexer declaration
    {
        // The arr object will throw IndexOutOfRange exception.
        get => arr[index];
        set => arr[index] = value;
    }
}

IndexerClass test = new IndexerClass();
System.Random rand = System.Random.Shared;
// Call the indexer to initialize its elements.
for (int i = 0; i < 10; i++)
{
    test[i] = rand.Next();
}
for (int i = 0; i < 10; i++)
{
    System.Console.WriteLine($"Element #{i} = {test[i]}");
}

/* Sample output:
    Element #0 = 360877544
    Element #1 = 327058047
    Element #2 = 1913480832
    Element #3 = 1519039937
    Element #4 = 601472233
    Element #5 = 323352310
    Element #6 = 1422639981
    Element #7 = 1797892494
    Element #8 = 875761049
    Element #9 = 393083859
*/

В приведенном выше примере можно использовать явную реализацию члена интерфейса с помощью полного имени члена интерфейса. Например.

string IIndexInterface.this[int index]
{
}

Тем не менее полное имя требуется только в целях устранения неоднозначности, если класс реализует более одного интерфейса с одинаковой сигнатурой индексатора. Например, если класс Employee реализует два интерфейса (ICitizen и IEmployee), оба из которых имеют одинаковую сигнатуру индексатора, требуется явная реализация члена интерфейса. Это значит, что потребуется следующее объявление индексатора:

string IEmployee.this[int index]
{
}

реализует индексатор в интерфейсе IEmployee, тогда как следующее объявление:

string ICitizen.this[int index]
{
}

реализует индексатор в интерфейсе ICitizen.

См. также