### C# 中 `string.Format` 的使用指南 #### 语法结构 在 C# 中，`string.Format` 方法用于返回一个字符串，该字符串表示指定对象的一个或多个实例的组合形式。其基本语法如下[^1]： ```csharp public static string Format(string format, params object[] args); ``` - 参数说明： - `format`: 表示格式化字符串的模板。 - `args`: 需要被插入到模板中的参数列表。 此方法支持多种重载版本，允许传递不同数量的参数来满足不同的需求。 --- #### 基本功能与用途 `string.Format` 是一种强大的工具，可以用来创建动态字符串并控制数据的显示方式。它通过占位符 `{}` 来定义变量的位置及其格式化规则[^2]。 例如，在以下代码中展示了如何将整数转换为带有千分位的货币格式： ```csharp int price = 1000; string result = string.Format("The product costs {0:C}", price); // 输出: The product costs $1,000.00 (具体符号取决于当前文化设置) ``` --- #### 占位符详解 占置符由花括号包裹的内容构成，通常具有以下几种形式[^3]: - **简单索引**: 如 `{0}`, `{1}` 等，代表按顺序替换对应的参数。 - **带宽度调整**: 可以指定字段宽度，正负值分别决定左对齐还是右对齐。例如：`{0,-10}` 或 `{1,5}`。 - **自定义格式化器**: 支持日期时间、数值等多种类型的特定格式化模式。比如对于日期类型可以用 `"yyyy-MM-dd"` 这样的格式串。 下面是一些具体的例子展示这些特性的应用情况: ```csharp DateTime now = DateTime.Now; // 使用简单的索引编号 Console.WriteLine(string.Format("{0} is the current date.", now)); // 设置固定列宽以及文字方向 Console.WriteLine(string.Format("|{0,-10}|{1,10}|", "LeftText", "RightText")); // 应用数字格式化处理 double value = Math.PI; Console.WriteLine(string.Format("PI as fixed point:{0:F2}, PI as percent:{0:P2}.", value)); ``` 以上程序片段会打印出类似这样的结果: ``` 2/7/2023 9:48:05 PM is the current date. |LeftText | RightText| PI as fixed point:3.14, PI as percent:314.16 %. ``` --- #### 文化敏感性考虑 值得注意的是，当涉及到货币金额或者日期表达的时候，默认行为可能会依据运行环境的文化设定而有所差异。如果希望强制采用某种特定区域的习惯，则可以通过提供额外的 `IFormatProvider` 实现类给另一个签名更丰富的函数原型调用[^4]。 ```csharp CultureInfo culture = new CultureInfo("fr-FR"); decimal euroPrice = 123.45m; Console.WriteLine(string.Format(culture, "{0:C}", euroPrice)); // 如果法语地区有效的话应该输出 €123,45 而不是其他样子 ``` ---