C# 之 String.Format详解

有兴趣的同学可以去看官方文档 String.Format Method (System) | Microsoft Docs

本文仅对官方文档中的内容进行提炼和总结

功能描述：把一些对象（Object）的值转化为字符串，并按照formats里的格式塞到另外一个字符串里

函数重载：

public static string Format(IFormatProvider provider, string format, object arg0)

public static string Format(IFormatProvider provider, string format, object arg0, object arg1)

public static string Format(IFormatProvider provider, string format, object arg0, object arg1, object arg2)

public static string Format(IFormatProvider provider, string format, params object[] args)

public static string Format(string format, object arg0)

public static string Format(string format, object arg0, object arg1)

public static string Format(string format, object arg0, object arg1, object arg2)

public static string Format(string format, params object[] args)

因为Format方法接收的参数是Object类型，所以对于值类型会涉及到装箱的操作

下面通过一些例子来详细介绍string.Format的用法：

如果你想要往另外一个字符串中插入某个object、variable、或者expression的值，那么就可以尝试使用String.Format，例如下面的例子：

Decimal pricePerOunce = 17.36m
String s = String.Format("The current price is {0} per ounce", pricePerOunce);
Console.WriteLine(s);
// Result: The current price is 17.36 per ounce.

你也可以去控制 大括号里的值 的 格式：

Decimal pricePerOunce = 17.36m;
String s = String.Format("The current price is {0:C2} per ounce.", pricePerOunce);
Console.WriteLine(s);
// Result if current culture is en-US:
//      The current price is $17.36 per ounce.

除了控制格式之外，你还可以控制 对齐（alignment） 和 间隔 (spacing)

String.Format的参数列表中，先是一个格式化的字符串，后面跟要往该字符串指定位置（即 { } 的位置）中插入的对象或者表达式（数量可以是任意多个，虽然String.Format提供了好几种重载方式，其实你并不用去关心究竟在用哪一个）。

大括号里可以写数字，对应了这些待插入项的序号（即第几个），例如：

string s = String.Format("At {0}, the temperature is {1}°C.", DateTime.Now, 20.4);
Console.WriteLine(s);
// Output similar to: 'At 4/10/2015 9:29:41 AM, the temperature is 20.4°C.'

控制格式（Control Formating）

如上文所说，我们可以在大括号 { } 里通过添加数字来指定插入参数列表中的第几个数（例如 {0} ，表示格式化字符串后面的第一个参数），同时我们也可以在数字后面使用冒号‘:’再后缀一些符号来控制更具体一些的格式。

例如：:d 提取了时间里的年月日  :t 提取了小时和分钟

string s = String.Format("It is now {0:d} at {0:t}", DateTime.Now);
Console.WriteLine(s);
// Output similar to: 'It is now 4/10/2015 at 10:04 AM'

这里读者可能会疑问：我咋知道有哪些字符串格式呢？确实这些格式化的种类还是比较多的，光靠记忆肯定是不行的，这里给出官方链接，按需要去查即可：

Standard numeric format strings​​​​​​

Standard date and time format strings | Microsoft Docs

Standard TimeSpan format strings | Microsoft Docs

Enumeration format strings | Microsoft Docs

你也可以使用一些格式的标识符（Format Specifier）来定制自己需要的格式类型

控制间距（Control Spacing)

你可以定义插入到目标字符串的字符串片段的宽度，例如，可以使用 {0,12} 表示插入的字符串的宽度为12

可以用于文本对齐，例如：

int[] years = { 2013, 2014, 2015 };
int[] population = { 1025632, 1105967, 1148203 };
var sb = new System.Text.StringBuilder();
sb.Append(String.Format("{0,6} {1,15}\n\n", "Year", "Population"));
for (int index = 0; index < years.Length; index++)
    sb.Append(String.Format("{0,6} {1,15:N0}\n", years[index], population[index]));

Console.WriteLine(sb);

// Result:
//      Year      Population
//
//      2013       1,025,632
//      2014       1,105,967
//      2015       1,148,203

控制左右对齐 (Control Alignment)

默认是右对齐，可以使用 如 {0, -12} 来设置为左对齐：

int[] years = { 2013, 2014, 2015 };
int[] population = { 1025632, 1105967, 1148203 };
String s = String.Format("{0,-10} {1,-10}\n\n", "Year", "Population");
for(int index = 0; index < years.Length; index++)
   s += String.Format("{0,-10} {1,-10:N0}\n",
                      years[index], population[index]);
Console.WriteLine($"\n{s}");
// Result:
//    Year       Population
//
//    2013       1,025,632
//    2014       1,105,967
//    2015       1,148,203