Int32.ToString 方法

定义

将此实例的数值转换为其等效的字符串表示形式。

重载

ToString(IFormatProvider)

使用指定的区域性特定格式信息将此实例的数值转换为其等效的字符串表示形式。

ToString()

将此实例的数值转换为其等效的字符串表示形式。

ToString(String)

使用指定的格式将此实例的数值转换为其等效的字符串表示形式。

ToString(String, IFormatProvider)

使用指定的格式和区域性特定的格式信息将此实例的数值转换为其等效的字符串表示形式。

ToString(IFormatProvider)

Source:
Int32.cs
Source:
Int32.cs
Source:
Int32.cs

使用指定的区域性特定格式信息将此实例的数值转换为其等效的字符串表示形式。

public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider? provider);

参数

provider
IFormatProvider

提供区域性特定的格式设置信息的对象。

返回

provider指定的此实例值的字符串表示形式。

实现

示例

以下示例使用表示多个不同区域性的 CultureInfo 对象显示 Int32 值的字符串表示形式。

int value = -16325;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325
//       -16325
//       -16325

注解

ToString(IFormatProvider) 方法使用指定区域性的 NumberFormatInfo 对象设置默认(“G”或常规)格式 Int32 值的格式。 如果要指定其他格式或当前区域性,请使用 ToString 方法的其他重载,如下所示:

使用格式 对于区域性 使用重载
默认格式(“G”) 默认(当前)区域性 ToString()
特定格式 默认(当前)区域性 ToString(String)
特定格式 特定区域性 ToString(String, IFormatProvider)

provider 参数是实现 IFormatProvider 接口的对象。 其 GetFormat 方法返回一个 NumberFormatInfo 对象,该对象提供有关此方法返回的字符串格式的区域性特定信息。 实现 IFormatProvider 的对象可以是以下任一对象:

如果 providernull 或无法从 provider获取 NumberFormatInfo 对象,则返回值使用线程当前区域性的 NumberFormatInfo 对象进行格式化。 有关线程当前区域性的信息,请参阅 Thread.CurrentCulture

.NET 提供广泛的格式支持,在以下格式设置主题中对此进行了更详细的描述:

另请参阅

适用于

.NET 9 和其他版本
产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString()

Source:
Int32.cs
Source:
Int32.cs
Source:
Int32.cs

将此实例的数值转换为其等效的字符串表示形式。

public override string ToString ();

返回

此实例值的字符串表示形式,如果值为负数,则由负号组成,数字序列从 0 到 9 不等,不带前导零。

示例

以下示例使用默认 ToString() 方法显示一个 Int32 值。 它还显示使用许多标准格式说明符产生的 Int32 值的字符串表示形式。 这些示例使用 en-US 区域性的格式设置约定显示。

int value = -16325;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325
Console.WriteLine(value.ToString("F"));         // Displays -16325.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325.00
Console.WriteLine(value.ToString("X"));         // Displays FFFFC03B

注解

ToString() 方法使用当前区域性的 NumberFormatInfo 对象设置默认(“G”或常规)格式 Int32 值的格式。 如果要指定不同的格式或区域性,请使用 ToString 方法的其他重载,如下所示:

使用格式 对于区域性 使用重载
默认格式(“G”) 特定区域性 ToString(IFormatProvider)
特定格式 默认(当前)区域性 ToString(String)
特定格式 特定区域性 ToString(String, IFormatProvider)

.NET 提供广泛的格式支持,在以下格式设置主题中对此进行了更详细的描述:

另请参阅

适用于

.NET 9 和其他版本
产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

Source:
Int32.cs
Source:
Int32.cs
Source:
Int32.cs

使用指定的格式将此实例的数值转换为其等效的字符串表示形式。

public string ToString (string format);
public string ToString (string? format);

参数

format
String

标准或自定义数字格式字符串。

返回

format指定的此实例值的字符串表示形式。

例外

format 无效或不受支持。

示例

以下示例使用每个受支持的标准数字格式说明符以及两个自定义数字格式字符串显示 Int32 值。 在将数值转换为字符串时,该示例使用 en-US 区域性的格式设置约定。

int value = -16325;
string specifier;

// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier));
// Displays:    P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    X: FFFFC03B

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): 16,325.00

注解

ToString(String) 方法通过使用表示当前区域性约定的 NumberFormatInfo 对象,以指定格式设置 Int32 值的格式。 如果要使用默认格式(“G”或常规)格式或指定其他区域性,请使用 ToString 方法的其他重载,如下所示:

使用格式 对于区域性 使用重载
默认格式(“G”) 默认(当前)区域性 ToString()
默认格式(“G”) 特定区域性 ToString(IFormatProvider)
特定格式 特定区域性 ToString(String, IFormatProvider)

format 参数可以是除“R”以外的任何有效的标准数字格式说明符,也可以是自定义数字格式说明符的任意组合。 如果 formatnull 或空字符串(“”),则此实例的返回值使用常规数值格式说明符(“G”)进行格式化。

.NET 提供广泛的格式支持,在以下格式设置主题中对此进行了更详细的描述:

此实例的返回值使用当前区域性的 NumberFormatInfo 进行格式化。

另请参阅

适用于

.NET 9 和其他版本
产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

Source:
Int32.cs
Source:
Int32.cs
Source:
Int32.cs

使用指定的格式和区域性特定的格式信息将此实例的数值转换为其等效的字符串表示形式。

public string ToString (string format, IFormatProvider provider);
public string ToString (string? format, IFormatProvider? provider);

参数

format
String

标准或自定义数字格式字符串。

provider
IFormatProvider

提供区域性特定的格式设置信息的对象。

返回

formatprovider指定的此实例值的字符串表示形式。

实现

例外

format 无效或不受支持。

示例

以下示例使用三种不同区域性支持的标准数字格式说明符中的每个正值和负值。

// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
                          CultureInfo.CreateSpecificCulture("fr-FR"),
                          CultureInfo.CreateSpecificCulture("es-ES") };
int positiveNumber = 1679;
int negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"};

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",
                        specifier, culture.Name,
                        positiveNumber.ToString(specifier, culture),
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//       G format using en-US culture:             1679            -3045
//       G format using fr-FR culture:             1679            -3045
//       G format using es-ES culture:             1679            -3045
//
//       C format using en-US culture:        $1,679.00      ($3,045.00)
//       C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//       C format using es-ES culture:       1.679,00 €      -3.045,00 €
//
//       D8 format using en-US culture:         00001679        -00003045
//       D8 format using fr-FR culture:         00001679        -00003045
//       D8 format using es-ES culture:         00001679        -00003045
//
//       E2 format using en-US culture:        1.68E+003       -3.05E+003
//       E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//       E2 format using es-ES culture:        1,68E+003       -3,05E+003
//
//       F format using en-US culture:          1679.00         -3045.00
//       F format using fr-FR culture:          1679,00         -3045,00
//       F format using es-ES culture:          1679,00         -3045,00
//
//       N format using en-US culture:         1,679.00        -3,045.00
//       N format using fr-FR culture:         1 679,00        -3 045,00
//       N format using es-ES culture:         1.679,00        -3.045,00
//
//       P format using en-US culture:     167,900.00 %    -304,500.00 %
//       P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//       P format using es-ES culture:     167.900,00 %    -304.500,00 %
//
//       X8 format using en-US culture:         0000068F         FFFFF41B
//       X8 format using fr-FR culture:         0000068F         FFFFF41B
//       X8 format using es-ES culture:         0000068F         FFFFF41B

注解

ToString(String, IFormatProvider) 方法使用指定区域性的 NumberFormatInfo 对象设置指定格式的 Int32 值的格式。 如果要使用默认格式或区域性设置,请使用 ToString 方法的其他重载,如下所示:

使用格式 对于区域性 使用重载
默认格式(“G”) 默认(当前)区域性 ToString()
默认格式(“G”) 特定区域性 ToString(IFormatProvider)
特定格式 默认(当前)区域性 ToString(String)

format 参数可以是标准或自定义数字格式字符串。 支持除“R”(或“r”)以外的所有标准数值格式字符串,所有自定义数字格式字符都支持。 如果 formatnull 或空字符串(“”),则此实例的返回值使用常规数值格式说明符(“G”)进行格式化。

provider 参数是实现 IFormatProvider 接口的对象。 其 GetFormat 方法返回一个 NumberFormatInfo 对象,该对象提供有关此方法返回的字符串格式的区域性特定格式信息。 实现 IFormatProvider 的对象可以是以下任一对象:

如果 providernull 或无法从 provider获取 NumberFormatInfo 对象,则此实例的返回值将格式化为当前区域性的 NumberFormatInfo

.NET 提供广泛的格式支持,在以下格式设置主题中对此进行了更详细的描述:

另请参阅

适用于

.NET 9 和其他版本
产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0