Sdílet prostřednictvím

Indexery v rozhraní (Průvodce programováním v C#)

  • Článek

Indexery lze deklarovat v rozhraní. Přístupové objekty indexerů rozhraní se liší od přístupových objektů indexerů tříd následujícími způsoby:

  • Přístupové objekty rozhraní nepoužívají modifikátory.
  • Příslušenství rozhraní obvykle nemá tělo.

Účelem přístupového objektu je indikovat, jestli je indexer jen pro čtení, jen pro čtení nebo jen pro zápis. Můžete zadat implementaci indexeru definovaného v rozhraní, ale to je vzácné. Indexery obvykle definují rozhraní API pro přístup k datovým polím a datová pole nelze definovat v rozhraní.

Následuje příklad přístupového objektu indexeru rozhraní:

public interface ISomeInterface
{
    //...

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

Podpis indexeru se musí lišit od podpisů všech ostatních indexerů deklarovaných ve stejném rozhraní.

Příklad

Následující příklad ukazuje, jak implementovat indexery rozhraní.

// 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
*/

V předchozím příkladu byste mohli použít explicitní implementaci člena rozhraní pomocí plně kvalifikovaného názvu člena rozhraní. Například

string IIndexInterface.this[int index]
{
}

Plně kvalifikovaný název je však nutný pouze k tomu, aby se zabránilo nejednoznačnosti, pokud třída implementuje více než jedno rozhraní se stejným podpisem indexeru. Pokud například Employee třída implementuje dvě rozhraní a ICitizen IEmployeea obě rozhraní mají stejný podpis indexeru, je nutná explicitní implementace člena rozhraní. To znamená, že následující deklarace indexeru:

string IEmployee.this[int index]
{
}

Implementuje indexer v IEmployee rozhraní, zatímco následující deklarace:

string ICitizen.this[int index]
{
}

Implementuje indexer v ICitizen rozhraní.

Viz také