C# 属性使用方法 C#如何定义和使用属性

C#属性必须含get或set访问器，是封装访问逻辑的方法而非字段别名；自动属性由编译器生成隐藏字段，适合无逻辑场景，手动属性支持校验/通知等控制；init仅限初始化赋值，纯get适合无状态计算，且不可在get中执行耗时操作。

属性定义必须带 get 或 set 访问器

在 C# 中，Property 不是字段的别名，而是封装了 get 和/或 set 访问器的方法对。没有访问器的“属性”语法不合法——编译器会报错 CS0542: 'X' does not contain a definition for 'Y' 或更直接的 CS0501: 'X.Y' must declare a body。

常见误写：

public String Name; // 这是字段，不是属性

它不触发属性机制，无法拦截读写、无法绑定 ui、不能被序列化器（如 jsonSerializer）默认识别为可序列化成员。

• 只读属性：用 get + private set 或 C# 6+ 的 get; init;
• 计算属性：只写 get，内部返回表达式或逻辑结果，不 backing field
• 自动实现属性：写 get; set; 即可，编译器自动生成隐藏字段

自动属性 vs 手动实现属性的区别在哪

自动属性（如 public int Age { get; set; }）由编译器生成一个不可见的 backing field，你无法在 get/set 中直接访问该字段名；而手动属性必须显式声明私有字段，并在访问器中读写它。

这意味着：如果你需要在赋值时校验、触发事件、或做日志，就必须用手动实现。例如：

private string _name; public string Name {     get => _name;     set     {         if (string.IsNullOrWhiteSpace(value))             throw new ArgumentException("Name cannot be null or empty");         _name = value.Trim();     } }

而自动属性做不到这点——除非用 init（仅限构造/初始化阶段）或配合 required（C# 11+），但它们仍不支持运行时校验。

• 自动属性适合数据载体（DTO、POCO）、配置类等无业务逻辑场景
• 手动属性适合需要控制访问语义的领域模型
• get; init; 可用于不可变对象构建，但初始化后 set 就失效

属性在序列化和 wpf 绑定中的行为差异

多数 json 序列化器（如 System.Text.Json、Newtonsoft.Json）默认只序列化 public 自动属性，忽略字段和 private 成员。但如果你把 set 设为 private 或 internal，System.Text.Json 仍能反序列化（只要类型有无参构造），而 Newtonsoft.Json 需要额外配置 JsonPropertyAttribute 或 ContractResolver。

WPF 的 Binding 则严格依赖 INotifyPropertyChanged 接口：只有在 set 中调用 OnPropertyChanged(nameof(X))，UI 才会响应变化。单纯定义 public string X { get; set; } 是不够的。

• 没实现 INotifyPropertyChanged 的属性，WPF 绑定显示值但不更新界面
• [JsonIgnore] 或 [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] 控制序列化行为，不影响属性本身
• 使用 record 类时，所有自动生成的属性默认是 get; init;，且支持 with 表达式

只读属性和 init-only 属性的适用边界

C# 9 引入 init 访问器，允许在对象初始化器或 with 表达式中赋值，之后不可再改。但它不是运行时只读——编译器只是禁止后续的 = 赋值，反射或 unsafe 代码仍可修改。

真正只读应选 get only + backing field（C# 6+ 支持 get => expr;），或 readonly 字段 + public getter 方法（非属性）。例如：

public string FullName => $"{FirstName} {LastName}"; // 计算属性，无存储开销

注意：若 FirstName 或 LastName 变了，FullName 不会自动刷新，除非你手动触发通知或用 ObservableProperty（MVVM Toolkit）等方案。

• get; init; 适合 DTO 初始化后不再变更的场景（如 API 响应对象）
• 纯 get 属性适合无状态计算，避免意外副作用
• 不要在 get 中做 I/O、锁、或耗时操作——属性访问预期是轻量的

属性真正的复杂点不在语法，而在语义控制权的让渡：你决定什么时候允许读、谁可以写、写之前要不要检查、写之后要不要通知。漏掉这些判断，后面调试绑定失败、序列化空值、或并发修改异常，都很难一眼定位。