C# 9.0 新特性预览 – init-only 属性

C# 9.0 新特性预览 – init-only 属性

前言

随着 .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,例如:

public class Person
{
    public string Name { get; private set; }
    // OR
    //public string Name { get; }
}

再添加一个拥有全部属性作为签名的构造方法:

...
public Person(string name)
{
    this.Name = name;
}
...

这样做虽然可以达到目的,但是带来了两个问题
1.假如属性增多,会带来工作量的成倍增加,以及不易维护
2.无法使用对象初始化器(object initializers)

var person = new Person
{
    Name = "Rwing" // Compile Error 
};

在这个情况下,init 关键字应运而生了。

语法

语法很简单,只需要将属性中的 set 关键字替换为 init 即可:

public string Name { get; init; }

以上代码会被大致翻译为:

private readonly string _name;
public string Name
{
    get { return _name; }
    set { _name = value;}
}

可以看到,与 set 的区别是,init 会为背后的字段添加 readonly 关键字。
这样我们就可以去掉一堆属性的构造方法转而使用对象初始化器了,并且达到了不可变的目的。

var person = new Person
{
    Name = "Rwing"
};
// 初始化后无法再次修改
person.Name = "Foo"; // Error: Name is not settable

这一语法,有很多场景需要配合同样在 C# 9.0 中新增的 record 类型使用。

哪些情况下可以被设置

  • 通过对象初始化器
  • 通过 with 表达式
  • 在自身或者派生类的构造方法中
  • 在标记为 init 的属性中
  • 在特性(attribute)类的命名参数属性中

以上场景不难理解,但是值得一提的是,只有 get 的属性是不可以派生类的构造方法中赋值的,但是 init 可以:

class Base
{
    public bool Foo { get; init; }
    public bool Bar { get; }
}

class Derived : Base
{
    Derived()
    {
        Foo = true;
        Bar = true; // ERROR
    }
}

此外有一种例外, 在以上场景中的 lambda 或本地函数中,也不允许被设置,例如:
原因也很简单,lambda 或本地函数在编译后已经不在构造函数中了。

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]