c# 索引器是什么

想让你的自定义对象也能像数组那样，用方括号 [] 来访问元素吗？C# 索引器就是为此而生的。别把它当成简单的语法糖，它可是编译器会生成真实方法（比如 get_Item 和 set_Item）的正式语言特性。

索引器本质：带参数的 this 属性

乍一看，索引器有点像属性，但它没有名字，声明时用的是 this[...]；用起来又有点像方法，但调用时不需要括号，直接写 obj[0] 或者 obj["key"] 就行。这里有几个关键点需要把握：

• this 是强制关键字，不能省略，也不能换成别的标识符。
• 参数类型非常灵活，支持 int、string，甚至是 C# 8 引入的 Index、Range，或者任何自定义类型。
• 它不能是静态成员，必须是实例级别的。所以，像 static this[int i] {...} 这样的写法是不合法的。
• 索引器本身不被归类为变量，因此不能作为 ref 或 out 参数传递。

为什么用索引器而不是公开内部数组？

核心动机在于封装性和安全控制。举个例子，假设你设计了一个温度记录类 TempRecord，内部用一个 float[] temps 数组来存储24小时的数据。如果直接把内部数组公开出去，用户就可能绕过所有校验规则，随意修改数据，这显然不够安全。

public class TempRecord
{
    private float[] temps = new float[24];

    public float this[int hour]
    {
        get
        {
            if (hour < 0 || hour >= 24)
                throw new ArgumentOutOfRangeException(nameof(hour));
            return temps[hour];
        }
        set
        {
            if (value < -100 || value > 100)
                throw new ArgumentException("温度超出合理范围");
            temps[hour] = value;
        }
    }
}

通过索引器，情况就不同了。当用户尝试执行 record[25] = 36.5f 时，程序会立刻抛出异常，明确告知访问越界。相比之下，如果直接操作 record.temps[25]，可能只会导致静默的错误，或者引发后续更难以追踪的逻辑问题。

常见踩坑：重载冲突与接口实现

在一个类里定义多个索引器是完全可行的，但前提是它们的参数签名必须严格区分开来。另外，在实现接口中的索引器时，有些细节容易出错：

• 如果两个索引器的参数类型相同但顺序不同（比如 this[string, int] 和 this[int, string]），这是允许的，构成了有效的重载。
• 如果只定义了 get 访问器而没有 set，那么你就创建了一个只读索引器。尝试对其赋值（如 collection[0] = "x"）会导致编译错误。
• 当一个类需要实现多个包含相同签名索引器的接口时，必须使用显式接口实现语法，例如：string IEmployee.this[int i] { get; set; }。
• 最后，一个重要的实践建议：避免在索引器的访问器内部执行耗时操作（比如查询数据库）。因为 obj[i] 这种写法看起来就像一次简单的内存访问，很容易让调用者忽略其背后可能存在的性能开销。

支持现代 C# 特性：Index 和 Range

从 C# 8 开始，你可以直接使用 ^（表示从末尾开始的索引）和 ..（表示范围）这样的简洁语法。但这需要你的索引器明确提供支持：

public string this[Index index] => words[index];
public string[] this[Range range] => words[range];

这样一来，调用时就能写出像 sentence[^1]（获取最后一个元素）或 sentence[1..3]（获取一个切片）这样直观的代码。需要注意的是，这种语法的支持依赖于底层数组或集合本身是否兼容 Index 和 Range 类型。如果底层不支持，错误会在运行时抛出，而不是在编译期被检查出来。

说到底，索引器真正的难点不在于它的语法怎么写，而在于设计时的权衡：这个通过 [] 进行的访问操作是否应该暴露给外部？它的边界条件该如何检查？可能产生的副作用又该如何控制？索引器将隐式的数组访问转化为了一个显式的类契约，一旦你提供了它，就需要对每一次 [...] 的调用负责。