c#如何使用自动属性_c#自动属性的3种方式

C# 自动属性：你以为的“只读”可能是个误会

说到C#的自动属性，语法简洁是它最大的优点。但你是否也曾疑惑过，那句简单的 public string Name { get; set; }，到底是不是默认就“只读”的？今天就来聊聊自动属性那些容易被误解的细节。

自动属性在 C# 中默认就是只读的吗？

答案很明确：不是。像 public string Name { get; set; } 这样的标准写法，默认生成的是完全可读可写的属性。编译器在背后默默创建了一个隐藏的后备字段，以及对应的 get 和 set 访问器。很多人觉得它“自带只读逻辑”，其实是一种错觉——真正的可写性，完全取决于你是否声明了 set 访问器。

一个常见的绊脚石是编译错误 CS0200（无法对只读属性赋值）。这通常是因为只写了 get; 而漏掉了 set;，或者在C# 9之后使用了 init 访问器，却试图在对象初始化完成后再次修改它。

• 如果只声明 get;，那这就是一个只读自动属性（只能在构造函数或 init 块中赋值）。
• 如果写成 get; private set;，意味着外部不可写，但类内部可以修改。
• 特别要注意，init 可不是 set 的简单别名。它只允许在对象初始化表达式（比如 new Person { Name = "A" }）或者使用 with 表达式时赋值，一旦对象创建完毕，再想修改就会触发错误。

三种典型自动属性写法及适用场景

常说的“三种方式”，本质上不是语法变体，而是访问器可见性与初始化语义的不同组合。选择哪一种，关键看你打算约束谁、在什么时间点允许修改值。

• public int Age { get; set; }：完全开放的属性。适用于数据传输对象（DTO）、配置类等不需要封装复杂逻辑的场景。不过，这么写也就放弃了对数据变更的控制能力。
• public string Code { get; private set; }：只能在构造时设值，之后对外只读。非常适合用来表示标识符类的字段，比如ID、订单号，可以有效防止被外部代码意外覆盖。
• public DateTime CreatedAt { get; init; } = DateTime.UtcNow;：这是C# 9引入的特性。它允许在对象创建时一次性赋值（完美支持对象初始化器语法），之后便不可更改。相比 private set，init 的语义更明确，并且与记录类型（record）的 with 表达式用法兼容。

这里有个细节值得注意：init 属性不能在构造函数内部直接赋值（那会绕过 init 的语义检查），必须通过对象初始化器或者 with 表达式来触发。

自动属性背后生成的字段会影响序列化或反射吗？

基本不影响。编译器生成的那个后备字段（名字通常像 k__BackingField），只是编译期的实现细节。在运行时通过反射（例如调用 typeof(T).GetProperties()）看到的仍然是属性本身，后备字段名并不会暴露出来。大多数序列化器（如 JSON.NET 或 System.Text.Json）默认也是按照属性名进行序列化的，而不是字段名。

• 以 System.Text.Json 为例，它默认会忽略带有 private set 或 init 的属性的 setter 调用，但只要属性有公开的 get 访问器，其值依然能被正确地序列化和反序列化。
• 当你使用 [JsonIgnore] 或 [JsonInclude] 这类特性时，作用对象是属性本身，而不是它背后的那个隐藏字段。
• 通过反射调用 PropertyInfo.SetValue() 方法，对于拥有 private set 的属性是有效的（因为访问器确实存在），但对于完全只读（仅有 get;）的属性，则会抛出 TargetException 异常。

什么时候该放弃自动属性，改用手动实现？

当属性的获取或设置需要嵌入额外逻辑时，就是自动属性该“退场”的时候了。比如数据验证、触发属性变更事件、实现延迟加载、进行线程同步，或者对值进行转换处理。这些场景都要求你显式地声明后备字段，并完整地手动实现 get 和 set 访问器。

• 举个例子：public string Name { get => _name?.Trim(); set => _name = string.IsNullOrWhiteSpace(value) ? null : value.Trim(); }。这种在存取时进行修剪和空值检查的逻辑，自动属性就无法胜任。
• 在性能敏感的路径上（比如高频循环中访问属性）：自动属性本身没有额外开销，但如果每次 get 都要触发一次复杂计算，就需要考虑改用缓存策略或者直接使用方法。
• 如果需要为 get 和 set 设置不同的访问级别（例如 public get + internal set）：C# 本身是支持的，像 public string Id { get; internal set; } 这样的写法依然属于自动属性的范畴。只有当你需要在访问器中插入业务逻辑时，才必须转为手动实现。

最后，一个容易被忽略的点：自动属性的初始化表达式（例如 = DateTime.Now）是在每个实例被构造时执行的，并不是静态共享、只计算一次的。这一点和普通字段的初始化行为保持一致，但有时会被误认为像 const 那样。理解这一点，对于把握对象的状态至关重要。