自定义插值字符串处理器通过实现带有[InterpolatedStringHandler]特性的类型，控制字符串插值行为，如格式转换、日志记录等。
在 C# 中，插值字符串处理器（Interpolated String Handler）允许你自定义如何处理和格式化插值字符串的内容。通过定义一个自定义的处理器类型，并配合 InterpolatedStringHandler 特性，你可以控制每个插值部分的格式化行为，比如改变输出格式、进行条件过滤、甚至记录日志。
创建自定义插值字符串处理器
要实现自定义格式化，你需要定义一个结构体或类，并应用 [InterpolatedStringHandler] 特性。该类型需要提供构造函数来接收字面量段数和插值表达式数量，并为每个插值项提供 AppendFormatted 方法。
例如，下面是一个将所有数值乘以 2 并格式化为带单位的字符串处理器：
[InterpolatedStringHandler]
public struct DoubleUnitHandler
{
private readonly StringBuilder _builder;
public DoubleUnitHandler(int literalLength, int formattedCount)
{
_builder = new StringBuilder(literalLength);
}
public void AppendLiteral(string text) => _builder.Append(text);
public void AppendFormattedzuojiankuohaophpcnTyoujiankuohaophpcn(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 value, string? format, IFormatProvider? provider)
{
var formattable = value as IFormattable;
var formatted = formattable != null ? formattable.ToString(format, provider) : value?.ToString();
_builder.Append($"[{formatted}]");
}
这样就可以在插值中使用如 $"{amount:C}" 这样的格式说明符，并由你的处理器处理。
基本上就这些。通过自定义插值字符串处理器，你可以精细控制字符串的构建过程，实现领域特定的格式化逻辑，比如日志级别着色、安全脱敏、单位转换等场景。
