C#如何实现链式调用 Fluent API设计与实现教程

链式调用是通过方法返回当前或新对象实现连续点号调用的API设计风格，如builder.SetName().SetAge().Build()，核心在于返回this、语义明确与阶段可控。

什么是链式调用与Fluent API

链式调用是指方法调用后返回当前对象（this）或新构建的对象，从而支持连续点号调用，比如 builder.SetName("Tom").SetAge(25).Build()。它不是语法特性，而是通过精心设计的返回值实现的可读性强、意图明确的API风格，常用于配置类、查询构造器、Builder模式等场景。

基础实现：返回 this 实现简单链式

最直接的方式是在每个设置方法中返回 this，让调用方能继续操作同一实例：

```csharp
public class PersonBuilder
{
    private string _name;
    private int _age;

    public PersonBuilder SetName(string name)
    {
        _name = name;
        return this;
    }

    public PersonBuilder SetAge(int age)
    {
        _age = age;
        return this;
    }

    public Person Build() => new Person(_name, _age);
}
```

这样就能写成：var p = new PersonBuilder().SetName("Alice").SetAge(30).Build();

进阶技巧：不可变性与泛型约束提升健壮性

为防止误用（如调用完 Build 后继续 Set），可引入状态控制或使用泛型分阶段类型：

标签： ai c#