---

C#索引器（Indexer）技术文档

C#索引器也被称为下标器（subscriptor），它使用类似于数组的语法，将类或结构体的实例中的元素组织为一个序列。这意味着可以通过类或结构体的实例来访问其元素。

在本文中，将详细讨论C#索引器的功能，用法和语法。

索引器的语法

C#索引器采取类似于属性（Property）的语法，使用关键字“this”来定义索引器的参数列表。下面是一个C#索引器的通用语法：

access-specifier return-type this [index] {
    get {
        //get accessor implementation
    }
    set {
        //set accessor implementation
    }
}

其中，

• access-specifier： 索引器的可访问性，可以是public、private、internal、protected等。
• return-type： 索引器的返回值类型。
• index： 索引器的参数列表，可以是一个或多个参数，使用逗号隔开。
• get： 索引器的读取器，获取元素的值。
• set： 索引器的写入器，修改元素的值。

索引器的用途

C#索引器的主要用途是为类或结构体提供类似于数组的访问方式。通过索引器，可以通过类或结构体的实例来访问其中的元素。因此，索引器可以在类或结构体中实现一些常规数据结构的操作（如队列、栈等），而无需创建一个单独的类来保存数据。

索引器的例子

下面是一个示例，演示如何创建一个索引器：

public class MyArray {
    private int[] data = new int[100];
    public int this[int i] {
        get {
            return data[i];
        }
        set {
            data[i] = value;
        }
    }
}

在这个例子中，我们创建了一个名为MyArray的类。该类包含一个整数数组，长度为100个元素。我们还在该类中定义了一个索引器，用于对数组进行访问。该索引器采用一个int类型的参数，用于指定数组中的元素位置。它还包含get和set访问器，用于获取和设置数组元素的值。

下面是如何使用MyArray类及其索引器访问数据的示例：

MyArray arr = new MyArray();
arr[0] = 10;
arr[1] = 20;
Console.WriteLine(arr[0]);   //输出10
Console.WriteLine(arr[1]);   //输出20

索引器的注意事项

使用C#索引器时，需要注意以下事项：

• 索引器只能定义在类或结构体中。
• 索引器可以有多个参数，但它们的类型和数量必须不同。
• 索引器可以定义为只读（只包含get访问器）或读写（包含get和set访问器）。
• 索引器不能使用ref或out关键字作为参数类型。
• 索引器不能是静态的。
• 索引器可以被重载，因此可以有多个索引器。
• 索引器的性能可能会稍低于直接访问数据的方法，因为它需要调用访问器方法来获取或设置数据。

总结

C#索引器是一种强大的特性，它使得类或结构体的实例可以像数组一样被访问。通过索引器，类或结构体可以实现一些常规数据结构的操作，从而增强程序的功能和性能。在编写C#程序时，需要了解索引器的语法、用途和注意事项，以充分利用它的优势。