C#如何使用Primary Constructors C# 12主构造函数详解

12次阅读

C# 12 主构造函数将参数直接声明在类/结构体头部,简化参数捕获与初始化;语法为class C(p1, p2),参数默认为类型体内局部变量,需配合readonly字段、init属性等持久化使用。

C#如何使用Primary Constructors C# 12主构造函数详解

C# 12 的主构造函数(Primary ConStructors)不是“给类加一个新构造函数”,而是把构造参数直接声明在类/结构体头部,让参数自动成为类型定义的一部分——它简化了参数捕获、字段初始化和只读属性生成的样板代码。

主构造函数的基本写法

语法非常简洁:在类或结构体名称后紧跟括号,里面写参数列表。这些参数默认是 作用域仅限于类型体内 的局部变量,但可配合 readonly 字段、init 属性或 field 关键字来持久化使用。

  • 类定义示例:public class Person(String name, int age); —— 这行就完成了声明,无需再写显式构造函数
  • 结构体同样支持:public struct Point(double x, double y);
  • 参数可以带默认值:class Config(string path, bool autoSave = true);

如何访问和使用主构造参数

主构造参数本身不能直接在外部访问,必须通过字段、属性或方法显式暴露。C# 12 提供了几种常用方式:

  • readonly 字段捕获:class Person(string name, int age) { public readonly string Name = name; public readonly int Age = age; }
  • initget 属性封装public string Name { get; init; } = name;(注意:需在属性初始化器中引用 name
  • field 关键字自动生成私有后备字段:public string Name => _name; private readonly string _name = name;(需手动写,但 field 不是关键字,只是常见命名习惯)
  • 也可在方法或属性 getter 中直接使用参数名(只要没被遮蔽):public override string ToString() => $"{name} ({age})";

主构造函数与基类构造调用

如果类继承自另一个类,主构造函数会自动尝试调用基类的无参构造函数。若基类没有无参构造,就必须显式指定调用哪个基类构造:

  • 写法:class Student(string name, int age) : Person(name, age + 1) { } —— 尾部的 : Person(...) 是基类构造调用
  • 此时主构造参数 nameage 可直接用于基类调用表达式中
  • 不能同时存在主构造函数和显式的实例构造函数(除非你放弃主构造,改用传统写法)

注意事项和限制

主构造函数很轻量,但也有些容易踩的坑:

  • 不支持 refoutparams 参数
  • 不能和传统的实例构造函数共存(即不能既有 class C(int x),又写 public C(int x) { ... }
  • 静态构造函数、静态字段初始化不受影响,仍按原有规则执行
  • 记录(record)类型本来就支持紧凑语法,主构造函数对 record classrecord struct 同样有效,且能自然融合 with 行为

基本上就这些。主构造函数不是银弹,但它让简单类型的定义更紧凑、意图更清晰,尤其适合 DTO、配置类、数据承载结构等场景。

text=ZqhQzanResources