C# 中的插值字符串处理器如何自定义格式化？

来源：这里教程网时间：2026-02-21 17:27:58 作者：

在 C# 中，插值字符串处理器（Interpolated String Handler）允许你自定义如何处理和格式化插值字符串的内容。通过定义一个自定义的处理器类型，并配合

InterpolatedStringHandler

特性，你可以控制每个插值部分的格式化行为，比如改变输出格式、进行条件过滤、甚至记录日志。

创建自定义插值字符串处理器

要实现自定义格式化，你需要定义一个结构体或类，并应用 [InterpolatedStringHandler] 特性。该类型需要提供构造函数来接收字面量段数和插值表达式数量，并为每个插值项提供

AppendFormatted

方法。

例如，下面是一个将所有数值乘以 2 并格式化为带单位的字符串处理器：

[InterpolatedStringHandler]
public struct DoubleUnitHandler
{
    private readonly StringBuilder _builder;
<pre class='brush:php;toolbar:false;'>public DoubleUnitHandler(int literalLength, int formattedCount)
{
    _builder = new StringBuilder(literalLength);
}
public void AppendLiteral(string text) => _builder.Append(text);
public void AppendFormatted<T>(T value)
{
    if (value is double d)
        _builder.Append($"{d * 2}x");
    else
        _builder.Append(value?.ToString());
}
public override string ToString() => _builder.ToString();

}

使用自定义处理器接收参数

你可以在方法参数中声明使用该处理器，并通过 CallerArgumentExpression 获取原始表达式文本，便于调试或日志记录。

public static void Log([InterpolatedStringHandlerArgument("unit")] DoubleUnitHandler handler,
                       [CallerArgumentExpression("handler")] string? expr = null)
{
    Console.WriteLine($"Logged: {handler}");
}

调用方式如下：

double rate = 1.5;
Log($"{rate} speed"); // 输出: Logged: 3x speed

支持更多格式化选项

你可以扩展

AppendFormatted

方法来接收格式字符串（formatString）和 IFormatProvider，从而支持标准 .NET 格式化规则。

public void AppendFormatted<T>(T value, string? format, IFormatProvider? provider)
{
    var formattable = value as IFormattable;
    var formatted = formattable != null ? formattable.ToString(format, provider) : value?.ToString();
    _builder.Append($"[{formatted}]");
}

这样就可以在插值中使用如