init访问器是C# 9.0引入的仅限对象初始化阶段使用的属性设置器,支持在对象初始化器中为只读属性赋值,之后不可修改,增强不可变性,适用于DTO、record等场景。

init访问器是 C# 9.0 引入的一种特殊属性设置器,用于在对象初始化期间为只读属性赋值,之后该属性便不能再被修改。它解决了以往只读属性(即仅有 set 的私有或无设置器的属性)无法在对象初始化器中设置的问题。
什么是 init 访问器?
在 C# 9.0 之前,如果一个属性只有 get 没有 set,就不能在对象初始化器中赋值:
public class Person
{
public String Name { get; private set; } // 或者没有 set
}
// 以下代码会报错:
var person = new Person { Name = “Alice” }; // 错误:Name 不能在此处设置
有了 init 访问器后,你可以这样写:
public class Person
{
public string Name { get; init; }
}
// 现在可以正常初始化:
var person = new Person { Name = “Alice” }; // 成功!
这个 init 访问器只允许在对象创建时通过对象初始化器设置一次,之后就无法再修改,即使在类内部也不行(除非通过构造函数等其他方式)。
init 访问器的核心特点
- 仅限对象初始化阶段使用:只能在
new表达式配合对象初始化器时调用。 - 不可变性增强:确保属性一旦初始化完成,就变成真正只读,有助于构建不可变类型。
- 替代传统 setter:可以用
init替代set,实现更安全的封装。 - 支持继承场景:子类可以在其构造函数或初始化器中为基类带有
init的属性赋值。
实际应用场景
init 访问器特别适合用于数据传输对象(DTO)、配置类、记录类型(record)等需要不可变性的场景。
public record Point(int X, int Y);
// 等价于:
public class Point
{
public int X { get; init; }
public int Y { get; init; }
public Point(int x, int y)
{
X = x;
Y = y;
}
}
结合 record 类型,C# 提供了简洁语法来定义不可变类型,而 init 是背后的关键机制之一。
注意事项
-
init访问器不能在普通方法、属性或构造函数之外被调用。 - 不能同时拥有
set和init,它们互斥。 - 反序列化框架(如 System.Text.json)已支持
init访问器,可正常反序列化只读属性。
基本上就这些。init 访问器虽小,却是 C# 向更现代、更安全的不可变编程迈出的重要一步。不复杂但容易忽略细节。