Indexelők az interfészekben (C# programozási útmutató)

Az indexelők egy felületen deklarálhatók. Az interfészindexelők tartozékai a következő módokon különböznek az osztályindexelők tartozékaitól:

• Az illesztő tartozékai nem használnak módosítókat.
• Az illesztő tartozékai általában nem rendelkeznek törzstel.

A tartozék célja annak jelzése, hogy az indexelő írásvédett, írásvédett vagy írásvédett-e. Előfordulhat, hogy egy felületen definiált indexelő implementációt biztosít, de ez ritkán fordul elő. Az indexelők általában egy API-t határoznak meg az adatmezők eléréséhez, és az adatmezők nem határozhatók meg a felületen.

Az alábbi példa egy felületindexelő tartozékra:

public interface ISomeInterface
{
    //...

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

Az indexelő aláírásának különböznie kell az azonos felületen deklarált összes többi indexelő aláírásától.

Példa

Az alábbi példa bemutatja, hogyan implementálhat felületindexelőket.

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

Az előző példában az explicit felülettag implementációját használhatja a felülettag teljes neve alapján. Példa:

string IIndexInterface.this[int index]
{
}

A teljes névre azonban csak a kétértelműség elkerülése érdekében van szükség, ha az osztály egynél több felületet implementál ugyanazzal az indexelő-aláírással. Ha például egy Employee osztály két illesztőt implementál, ICitizen és IEmployeemindkét illesztő ugyanazzal az indexelő aláírással rendelkezik, az explicit felülettag implementálására van szükség. Ez az indexelő következő deklarációja:

string IEmployee.this[int index]
{
}

implementálja az indexelőt az IEmployee interfészen, míg a következő deklaráció:

string ICitizen.this[int index]
{
}

implementálja az indexelőt az ICitizen interfészen.

Lásd még

• Indexelők
• Tulajdonságok
• Felületek