共用方式為


介面中的索引子 (C# 程式設計手冊)

索引子可以在interface (C# 參考) 上宣告。 介面索引子的存取子與類別索引子的存取子,兩者之間差異如下:

  • 介面存取子不使用修飾詞。

  • 介面存取子不具有主體。

因此,存取子的目的是為指示這個索引子是讀寫、唯讀或唯寫性質。

下列是介面索引子存取子的範例:

public interface ISomeInterface
{
    //...

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

索引子的簽章必須與宣告在相同介面的其他所有索引子的簽章不同。

範例

下列範例將示範如何實作介面索引子。

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

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

    class MainClass
    {
        static void Main()
        {
            IndexerClass test = new IndexerClass();
            System.Random rand = new System.Random();
            // 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 #{0} = {1}", i, test[i]);
            }

            // Keep the console window open in debug mode.
            System.Console.WriteLine("Press any key to exit.");
            System.Console.ReadKey();
        }
    }
    /* 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
     */


在上述範例中,您可以以完整的介面成員名稱來使用明確介面成員實作。 例如:

public string ISomeInterface.this 
{ 
} 

然而,只有在這種類別以相同的索引子簽章來實作一個以上的介面時,才需要使用這種完整名稱,以避免模稜兩可 (Ambiguity) 的狀況。 例如,如果 Employee 類別實作 ICitizen 和 IEmployee 兩個介面,而且兩個介面都具有相同的索引子簽章 (Indexer Signature),如此一來,就需要有明確介面成員實作。 也就是,下面這個索引子宣告:

public string IEmployee.this 
{ 
} 

會實作在 IEmployee 介面上的索引子,而下面這段宣告:

public string ICitizen.this 
{ 
} 

會實作在 ICitizen 介面上的索引子。

請參閱

參考

索引子 (C# 程式設計手冊)

屬性 (C# 程式設計手冊)

介面 (C# 程式設計手冊)

概念

C# 程式設計手冊