索引器概述

索引器概述

• 使用索引器可以用类似于数组的方式为对象建立索引
• get 访问器返回值。 set 访问器分配值。
• this 关键字用于定义索引器。
• value 关键字用于定义由 set 索引器分配的值。
• 索引器不必根据整数值进行索引，由您决定如何定义特定的查找机制。
• 索引器可被重载。
• 索引器可以有多个形参，例如当访问二维数组时。

class SampleCollection<T>{    // 声明一个数组来存储数据元素.    private T[] arr = new T[100];    // 定义索引器    public T this[int i]    {        get        {            return arr[i];        }        set        {            arr[i] = value;        }    }}// 这个类展示了主程序中如何使用索引器class Program{    static void Main(string[] args)    {        // 声明一个SampleCollection类型的实例        SampleCollection<string> stringCollection = new SampleCollection<string>();        stringCollection[0] = "Hello, World";        System.Console.WriteLine(stringCollection[0]);    }}

---

示例 1
下面的示例说明如何声明私有数组字段、temps 和索引器。 使用索引器可直接访问实例 tempRecord[i]。 另一种使用索引器的方法是将数组声明为 public 成员并直接访问它的成员 tempRecord.temps[i]。
请注意，当计算索引器的访问时（例如，在 Console.Write 语句中），将调用 get 访问器。 因此，如果 get 访问器不存在，将发生编译时错误。

class TempRecord{    // Array of temperature values    private float[] temps = new float[10] { 56.2F, 56.7F, 56.5F, 56.9F, 58.8F,                                             61.3F, 65.9F, 62.1F, 59.2F, 57.5F };    // To enable client code to validate input     // when accessing your indexer.    public int Length    {        get { return temps.Length; }    }    // Indexer declaration.    // If index is out of range, the temps array will throw the exception.    public float this[int index]    {        get        {            return temps[index];        }        set        {            temps[index] = value;        }    }}class MainClass{    static void Main()    {        TempRecord tempRecord = new TempRecord();        // Use the indexer's set accessor        tempRecord[3] = 58.3F;        tempRecord[5] = 60.1F;        // Use the indexer's get accessor        for (int i = 0; i < 10; i++)        {            System.Console.WriteLine("Element #{0} = {1}", i, tempRecord[i]);        }        // Keep the console window open in debug mode.        System.Console.WriteLine("Press any key to exit.");        System.Console.ReadKey();    }}/* Output:        Element #0 = 56.2        Element #1 = 56.7        Element #2 = 56.5        Element #3 = 58.3        Element #4 = 58.8        Element #5 = 60.1        Element #6 = 65.9        Element #7 = 62.1        Element #8 = 59.2        Element #9 = 57.5    */

---

使用其他值进行索引:
C# 并不将索引类型限制为整数。 例如，对索引器使用字符串可能是有用的。 通过搜索集合内的字符串并返回相应的值，可以实现此类索引器。 由于访问器可被重载，字符串和整数版本可以共存。

---

示例 2
在此例中，声明了存储星期几的类。 声明了一个 get 访问器，它接受字符串（天名称），并返回相应的整数。 例如，星期日将返回 0，星期一将返回 1，等等。

// Using a string as an indexer valueclass DayCollection{    string[] days = { "Sun", "Mon", "Tues", "Wed", "Thurs", "Fri", "Sat" };    // This method finds the day or returns -1    private int GetDay(string testDay)    {        for (int j = 0; j < days.Length; j++)        {            if (days[j] == testDay)            {                return j;            }        }        throw new System.ArgumentOutOfRangeException(testDay, "testDay must be in the form \"Sun\", \"Mon\", etc");    }    // The get accessor returns an integer for a given string    public int this[string day]    {        get        {            return (GetDay(day));        }    }}class Program{    static void Main(string[] args)    {        DayCollection week = new DayCollection();        System.Console.WriteLine(week["Fri"]);        // Raises ArgumentOutOfRangeException        System.Console.WriteLine(week["Made-up Day"]);        // Keep the console window open in debug mode.        System.Console.WriteLine("Press any key to exit.");        System.Console.ReadKey();    }}// Output: 5

---

可靠编程
提高索引器的安全性和可靠性有两种主要的方法：

• 确保结合某一类型的错误处理策略，以处理万一客户端代码传入无效索引值的情况。 在本主题前面的第一个示例中，TempRecord 类提供了 Length 属性，使客户端代码能够在将输入传递给索引器之前对其进行验证。 也可以将错误处理代码放入索引器自身内部。 确保为用户记录在索引器的访问器中引发的任何异常。

• 应当为 get 和 set 访问器的可访问性设置尽可能多的限制。 这一点对 set 访问器尤为重要。

  ---

  接口中的索引器

接口索引器的访问器与类索引器的访问器具有以下方面的不同：
- 接口访问器不使用修饰符。
- 接口访问器没有具体实现。
- 因此，访问器的用途是指示索引器是读写、只读还是只写。

以下是接口索引器访问器的示例：

public interface ISomeInterface{    //...    // 声明索引器:    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     */

---

属性和索引器之间的比较