C# 索引器(Indexer)超全笔记实用指南

佚名 2026-10-13 08:50:02

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“C# 索引器(Indexer)超全笔记”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

一、索引器核心概念

1. 什么是索引器

理解这一步时，默认情况下，自定义类的对象不能借助 [索引] 访问（只有数组、List 能够）。

索引器作用：给自定义类添加 this[参数] 特殊属性，让对象兼容对象[索引/参数] 的方式取值、赋值。

本质：带参数的特殊属性，专门用来简化对象内部集合的访问。

2. 索引器固定语法

// 访问修饰符 返回值 this[参数]
public 返回值 this[参数类型 参数名]
{
    get { 取值逻辑 }
    set { 赋值逻辑，value 为传入的值 }
}

3. 核心特点

采用 this 关键字定义
兼容 get、set 访问器（可读可写/只读均可）
兼容重载（多个不同参数的索引器）
只能定义在类、结构体中

二、基础索引器：数字索引（int 参数）

业务场景

落到代码里，ClassRoom 班级内部封装学生集合，借助索引器实现 room[0] 直接拿到/修改学生对象。

完整核心代码

class ClassRoom
{
    // 内部封装学生集合
    public List<Student> list = new List<Student>();

    // 添加学生方法
    public void Add(Student stu)
    {
        list.Add(stu);
    }

    // 数字索引器：通过下标 增改查
    public Student this[int index]
    {
        get
        {
            // 根据索引返回对应学生对象
            return list[index];
        }
        set
        {
            // 根据索引修改集合中的元素
            list[index] = value;
        }
    }
}

调用方式

// 完整调用测试代码
ClassRoom room = new ClassRoom();
// 添加两名学生
room.Add(new Student() { Name = "张三", Age = 10 });
room.Add(new Student() { Name = "李四", Age = 20 });

// 索引器set赋值：修改下标0的学生对象
room[0] = new Student() { Name = "王五", Age = 30 };

// 索引器get取值：读取下标0、1的学生信息
Console.WriteLine(room[0].Name + room[0].Age); // 输出：王五30
Console.WriteLine(room[1].Name + room[1].Age); // 输出：李四20

三、索引器重载（重点考点）

索引器兼容参数类型不同实现重载，一个类能够定义多个索引器！

1. 字符串索引器（按姓名查询对象）

功能：借助 room["李四"] 根据姓名匹配并得到学生对象

public Student this[string v]
{
    get
    {
        // 模糊匹配姓名，返回对应学生对象
        return list.Find(v1 => v1.Name == v);
    }
}

完整调用测试（字符串索引器查询学生年龄）：

// 根据姓名查询李四、王五的年龄
Console.WriteLine(room["李四"].Age);  // 输出：20
Console.WriteLine(room["王五"].Age); // 输出：30

2. 对象参数索引器（根据学生对象查索引下标）

功能：借助传入学生对象，匹配姓名，得到该学生在集合中的索引位置

public int this[Student s1]
{
    get
    {
        // 根据对象姓名匹配，返回索引值
        int index = list.FindIndex(v => v.Name.Equals(s1.Name));
        return index;
    }
}

完整调用测试（对象索引器查询对应下标）：

// 传入学生对象，获取该学生在集合中的索引位置
int index1 = room[new Student() { Name = "李四", Age = 20 }];
int index2 = room[new Student() { Name = "王五", Age = 30 }];
Console.WriteLine(index1); // 输出：1
Console.WriteLine(index2); // 输出：0

索引器重载总结

同一个类中三个索引器，参数不同、功能不同，合法重载：

this[int index]：下标查对象、改对象
this[string name]：姓名查对象
this[Student stu]：对象查下标

四、进阶索引器：动态数组扩容索引器（实战练习）

业务需求

结合项目来看，封装 string 数组，自定义索引器：索引超出数组长度时，自动扩容数组同时赋值，突破普通数组固定长度限制。

完整核心代码

public class Student
{
    private string[] names = new string[4];
    // 只读属性，默认返回第一个元素
    public string Name { get => names[0]; }

    // 构造函数初始化数组
    public Student(string[] s)
    {
        names = s;
    }

    // 自定义索引器：支持自动扩容
    public string this[int index]
    {
        get
        {
            // 根据索引取值
            return names[index];
        }
        set
        {
            // 判断索引是否超出数组长度
            if (index >= names.Length)
            {
                // 1. 创建长度+1的新数组
                string[] newArr = new string[names.Length + 1];
                // 2. 拷贝原数组数据到新数组
                Array.Copy(names, newArr, names.Length);
                // 3. 给新索引位置赋值
                newArr[index] = value;
                // 4. 替换原数组，完成扩容
                names = newArr;
            }
            else
            {
                // 索引合法，直接赋值
                names[index] = value;
            }
        }
    }
}

完整调用测试

// 动态扩容索引器 完整调用代码
// 初始化数组数据
Student stu = new Student(new string[] { "六一", "高考", "中考", "端午" });

// 读取默认第一个元素
Console.WriteLine(stu.Name); // 输出：六一

// 修改原有下标数据
stu[0] = "期末";
Console.WriteLine(stu[0]); // 输出：期末
Console.WriteLine(stu[1]); // 输出：高考
Console.WriteLine(stu[2]); // 输出：中考
Console.WriteLine(stu[3]); // 输出：端午

// 超出原数组长度，自动扩容赋值
stu[4] = "12";
Console.WriteLine(stu[4]); // 输出：12