在 C# 10 中，可以使用插值字符串处理程序（Interpolated String Handler）来构建字符串类型的返回值。插值字符串是以$符号为前缀的字符串，其中可以插入表达式。.NET 库中的许多 API 都使用了这个特性。本文将介绍如何使用插值字符串处理程序来构建返回值，并提供示例来解释其使用方法。

创建插值字符串处理程序

可以通过以下步骤来创建一个插值字符串处理程序：

1. 创建一个类，实现 IFormatProvider 和 ICustomFormatter 接口。

public class MyFormatter : IFormatProvider, ICustomFormatter
{
    public object? GetFormat(Type? formatType)
    {
        if (formatType == typeof(ICustomFormatter))
            return this;
        else
            return null;
    }

    public string Format(string? format, object? arg, IFormatProvider? formatProvider)
    {
        if (arg == null) throw new ArgumentNullException(nameof(arg));
        if (!this.Equals(formatProvider)) return null;

        if (format == "U")
        {
            return arg.ToString().ToUpper();
        }
        else
        {
            return arg.ToString();
        }
    }
}

1. 在主函数中使用自定义的格式提供程序。

MyFormatter formatter = new MyFormatter();
string result = $"{someValue, U}"; //使用格式化字符串语法调用自定义格式提供程序
Console.WriteLine(result); //输出 SOMEVALUE

使用插值字符串处理程序

创建插值字符串处理程序后，可以通过以下示例来了解如何使用它来构建返回值。

示例 1: 格式化数字

下面的示例演示如何使用插值字符串处理程序来格式化数字。该程序将以百分比格式返回一个数字。

public class MyFormatter : IFormatProvider, ICustomFormatter
{
    public object? GetFormat(Type? formatType)
    {
        if (formatType == typeof(ICustomFormatter))
            return this;
        else
            return null;
    }

    public string Format(string? format, object? arg, IFormatProvider? formatProvider)
    {
        if (arg == null) throw new ArgumentNullException(nameof(arg));
        if (!this.Equals(formatProvider)) return null;

        if (format == "P")
        {
            return $"{(double)arg:P}";
        }
        else
        {
            return arg.ToString();
        }
    }
}

MyFormatter formatter = new MyFormatter();
double value = 0.75;
string result = $"{value, P}"; //使用格式化字符串语法调用自定义格式提供程序
Console.WriteLine(result); //输出 75.00%

示例 2: 格式化日期

下面的示例演示如何使用插值字符串处理程序来格式化日期。

public class MyFormatter : IFormatProvider, ICustomFormatter
{
    public object? GetFormat(Type? formatType)
    {
        if (formatType == typeof(ICustomFormatter))
            return this;
        else
            return null;
    }

    public string Format(string? format, object? arg, IFormatProvider? formatProvider)
    {
        if (arg == null) throw new ArgumentNullException(nameof(arg));
        if (!this.Equals(formatProvider)) return null;
        if (arg is DateTime dateTime)
            {
                if (format == "D")
                {
                    return dateTime.ToString("d");
                }
                else if (format == "T")
                {
                    return dateTime.ToString("t");
                }
                else
                {
                    return arg.ToString();
                }
            }
            else
            {
                return arg.ToString();
            }
        }
    }
}


MyFormatter formatter = new MyFormatter();
DateTime date = DateTime.Now;
string result1 = $"{date, D}"; //使用格式化字符串语法调用自定义格式提供程序
string result2 = $"{date, T}"; //使用格式化字符串语法调用自定义格式提供程序
Console.WriteLine(result1); //输出当前日期的短日期字符串形式
Console.WriteLine(result2); //输出当前日期的短时间字符串形式

总结

通过使用插值字符串处理程序，我们可以更加灵活地构建字符串类型的返回值。在本文中，我们通过示例演示了如何创建和使用插值字符串处理程序，以及如何使用自定义的格式提供程序来格式化数字和日期。希望这篇文章能够帮助您更好地理解 C# 10 中的插值字符串处理程序。