C# 中的插值字符串处理器如何自定义格式化？-C#.Net教程-PHP中文网

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

畫卷琴夢

发布： 2025-10-12 11:51:01

原创

491人浏览过

自定义插值字符串处理器通过实现带有[InterpolatedStringHandler]特性的类型，控制字符串插值行为，如格式转换、日志记录等。

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

在 C# 中，插值字符串处理器（Interpolated String Handler）允许你自定义如何处理和格式化插值字符串的内容。通过定义一个自定义的处理器类型，并配合 InterpolatedStringHandler 特性，你可以控制每个插值部分的格式化行为，比如改变输出格式、进行条件过滤、甚至记录日志。

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

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

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

比格设计

比格设计是135编辑器旗下一款一站式、多场景、智能化的在线图片编辑器

124

查看详情

[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}]");
}

登录后复制

这样就可以在插值中使用如 $"{amount:C}" 这样的格式说明符，并由你的处理器处理。

基本上就这些。通过自定义插值字符串处理器，你可以精细控制字符串的构建过程，实现领域特定的格式化逻辑，比如日志级别着色、安全脱敏、单位转换等场景。

以上就是C# 中的插值字符串处理器如何自定义格式化？的详细内容，更多请关注php中文网其它相关文章！