前言
随着 .NET 5 发布日期的日益临近,其对应的 C# 新版本已确定为 C# 9.0,其中新增加的特性(或语法糖)也已基本锁定,本系列文章将向大家展示它们。
目录
[C# 9.0 新特性预览 - 类型推导的 new] [C# 9.0 新特性预览 - 空参数校验] [C# 9.0 新特性预览 - 顶级语句] [C# 9.0 新特性预览 - init-only 属性] [C# 9.0 新特性预览 - Record 类型] [C# 9.0 新特性预览 - 模式匹配的改善] [C# 9.0 新特性预览 - 源代码生成器] [C# 9.0 新特性预览 - 其他小的变化]
只初始化 setter (Init Only Setters)
这个特性允许创建只初始化(init only)的属性和索引器,使得 C# 中的不可变模型更加灵活。
背景
在此之前,我们创建实体类/POCO类/DTO类等等模型类的时候,都期望属性只读不允许从外部修改,会将属性的 setter 设为私有或者干脆不设置 setter,例如:
代码语言:javascript复制public class Person
{
public string Name { get; private set; }
// OR
//public string Name { get; }
}
再添加一个拥有全部属性作为签名的构造方法:
代码语言:javascript复制...
public Person(string name)
{
this.Name = name;
}
...
这样做虽然可以达到目的,但是带来了两个问题 1.假如属性增多,会带来工作量的成倍增加,以及不易维护 2.无法使用对象初始化器(object initializers)
代码语言:javascript复制var person = new Person
{
Name = "Rwing" // Compile Error
};
在这个情况下,init 关键字应运而生了。
语法
语法很简单,只需要将属性中的 set 关键字替换为 init 即可:
代码语言:javascript复制public string Name { get; init; }
以上代码会被大致翻译为:
代码语言:javascript复制private readonly string _name;
public string Name
{
get { return _name; }
set { _name = value;}
}
可以看到,与 set 的区别是,init 会为背后的字段添加 readonly 关键字。 这样我们就可以去掉一堆属性的构造方法转而使用对象初始化器了,并且达到了不可变的目的。
代码语言:javascript复制var person = new Person
{
Name = "Rwing"
};
// 初始化后无法再次修改
person.Name = "Foo"; // Error: Name is not settable
这一语法,有很多场景需要配合同样在 C# 9.0 中新增的 record 类型使用。
哪些情况下可以被设置
- 通过对象初始化器
- 通过 with 表达式
- 在自身或者派生类的构造方法中
- 在标记为 init 的属性中
- 在特性(attribute)类的命名参数属性中
以上场景不难理解,但是值得一提的是,只有 get 的属性是不可以派生类的构造方法中赋值的,但是 init 可以:
代码语言:javascript复制class Base
{
public bool Foo { get; init; }
public bool Bar { get; }
}
class Derived : Base
{
Derived()
{
Foo = true;
Bar = true; // ERROR
}
}
此外有一种例外, 在以上场景中的 lambda 或本地函数中,也不允许被设置,例如: 原因也很简单,lambda 或本地函数在编译后已经不在构造函数中了。
代码语言:javascript复制public class Class
{
public string Property { get; init; }
Class()
{
System.Action a = () =>
{
Property = null; // ERROR
};
local();
void local()
{
Property = null; // ERROR
}
}
}
参考
[Proposal: Init Only Setters] [InitOnlyMemberTests.cs]