UInt64.ToString 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

重载

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

ToString()

Source:: UInt64.cs

Source:: UInt64.cs

Source:: UInt64.cs

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

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

String

此实例值的字符串表示形式，由介于 0 到 9 的数字序列组成，不带符号或前导零。

示例

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

using System;

public class Example
{
   public static void Main()
   {
      ulong value = 163249057;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());      
      Console.WriteLine();
      
      // Define an array of format specifiers.
      string[] formats = { "G", "C", "D", "F", "N", "X" };
      // Display value using the standard format specifiers.
      foreach (string format in formats)
         Console.WriteLine("{0} format specifier: {1,16}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       163249057
//       
//       G format specifier:        163249057
//       C format specifier:  $163,249,057.00
//       D format specifier:        163249057
//       F format specifier:     163249057.00
//       N format specifier:   163,249,057.00
//       X format specifier:          9BAFBA1

let value = 163249057uL
// Display value using default ToString method.
printfn $"{value.ToString()}\n"      

// Define an array of format specifiers.
let formats = [| "G"; "C"; "D"; "F"; "N"; "X" |]
// Display value using the standard format specifiers.
for format in formats do
    printfn $"{format} format specifier: {value.ToString format,16}" 
// The example displays the following output:
//       163249057
//       
//       G format specifier:        163249057
//       C format specifier:  $163,249,057.00
//       D format specifier:        163249057
//       F format specifier:     163249057.00
//       N format specifier:   163,249,057.00
//       X format specifier:          9BAFBA1

Module Example
   Public Sub Main()
      Dim value As ULong = 163249057
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            
      Console.WriteLine()
      
      ' Define an array of format specifiers.
      Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
      ' Display value using the standard format specifiers.
      For Each format As String In formats
         Console.WriteLine("{0} format specifier: {1,16}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' The example displays the following output:
'       163249057
'       
'       G format specifier:        163249057
'       C format specifier:  $163,249,057.00
'       D format specifier:        163249057
'       F format specifier:     163249057.00
'       N format specifier:   163,249,057.00
'       X format specifier:          9BAFBA1

注解

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

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

另请参阅

Parse(String)
.NET 中的格式设置类型

适用于

ToString(IFormatProvider)

Source:: UInt64.cs

Source:: UInt64.cs

Source:: UInt64.cs

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

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

参数

provider: IFormatProvider

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

String

此实例值的字符串表示形式，由介于 0 到 9 的数字序列组成，不带符号或前导零。

实现

ToString(IFormatProvider)

示例

以下示例使用多种格式提供程序设置 64 位有符号整数值的格式，包括一个用于固定区域性。该示例的输出说明，无论格式提供程序如何，ToString(IFormatProvider) 方法返回的格式化字符串都是相同的。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define an array of CultureInfo objects.
      CultureInfo[] ci = { new CultureInfo("en-US"), 
                           new CultureInfo("fr-FR"), 
                           CultureInfo.InvariantCulture }; 
      ulong value = 18709243;
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        GetName(ci[0]), GetName(ci[1]), GetName(ci[2])); 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));   
   }

   private static string GetName(CultureInfo ci)
   {
      if (ci.Equals(CultureInfo.InvariantCulture))
         return "Invariant";
      else
         return ci.Name;         
   }
}
// The example displays the following output:
//             en-US          fr-FR      Invariant
//          18709243       18709243       18709243

open System.Globalization

let getName (ci: CultureInfo) =
    if ci.Equals CultureInfo.InvariantCulture then "Invariant"
    else ci.Name

// Define an array of CultureInfo objects.
let ci = 
    [| CultureInfo "en-US" 
       CultureInfo "fr-FR" 
       CultureInfo.InvariantCulture |]

let value = 18709243uL

printfn $"  {getName ci[0],12}   {getName ci[1],12}   {getName ci[2],12}"
printfn $"  {value.ToString ci[0],12}   {value.ToString ci[1],12}   {value.ToString ci[2],12}" 
// The example displays the following output:
//             en-US          fr-FR      Invariant
//          18709243       18709243       18709243

Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define an array of CultureInfo objects.
      Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
                                  New CultureInfo("fr-FR"), _
                                  CultureInfo.InvariantCulture } 
      Dim value As ULong = 18709243
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        GetName(ci(0)), GetName(ci(1)), GetName(ci(2))) 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        value.ToString(ci(0)), value.ToString(ci(1)), value.ToString(ci(2)))            
      
   End Sub
   
   Private Function GetName(ci As CultureInfo) As String
      If ci.Equals(CultureInfo.InvariantCulture) Then
         Return "Invariant"
      Else
         Return ci.Name
      End If   
   End Function
End Module
' The example displays the following output:
'             en-US          fr-FR      Invariant
'          18709243       18709243       18709243

注解

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

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

provider 参数是 IFormatProvider 实现。其 GetFormat 方法返回一个提供区域性特定格式信息的 NumberFormatInfo 对象。但是，当使用常规数值格式说明符（“G”）进行格式设置时，不会使用 NumberFormatInfo 的属性。

另请参阅

Parse(String)
.NET 中的格式设置类型

适用于

ToString(String)

Source:: UInt64.cs

Source:: UInt64.cs

Source:: UInt64.cs

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

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

参数

format: String

数字格式字符串。

String

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

例外

FormatException

format 参数无效。

示例

以下示例使用每个标准格式字符串和一些自定义格式字符串显示 64 位无符号整数值。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      ulong value = 217960834;
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "000000.0", "#.0", 
                              "00000000;(0);**Zero**" };
      
      foreach (string specifier in specifiers)
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
   }
}
// The example displays the following output:
//       G: 217960834
//       C: $217,960,834.00
//       D3: 217960834
//       E2: 2.18E+008
//       e3: 2.180e+008
//       F: 217960834.00
//       N: 217,960,834.00
//       P: 21,796,083,400.00 %
//       X: CFDD182
//       000000.0: 217960834.0
//       #.0: 217960834.0
//       00000000;(0);**Zero**: 217960834

let value = 217960834uL
let specifiers = 
    [| "G"; "C"; "D3"; "E2"; "e3"; "F" 
       "N"; "P"; "X"; "000000.0"; "#.0" 
       "00000000(0)**Zero**" |]
      
for specifier in specifiers do
    printfn $"{specifier}: {value.ToString specifier}"
// The example displays the following output:
//       G: 217960834
//       C: $217,960,834.00
//       D3: 217960834
//       E2: 2.18E+008
//       e3: 2.180e+008
//       F: 217960834.00
//       N: 217,960,834.00
//       P: 21,796,083,400.00 %
//       X: CFDD182
//       000000.0: 217960834.0
//       #.0: 217960834.0
//       00000000(0)**Zero**: 217960834

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As ULong = 217960834 
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "000000.0", "#.0", _
                                     "00000000;(0);**Zero**" }
      
      For Each specifier As String In specifiers
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
      Next
   End Sub
End Module
' The example displays the following output:
'       G: 217960834
'       C: $217,960,834.00
'       D3: 217960834
'       E2: 2.18E+008
'       e3: 2.180e+008
'       F: 217960834.00
'       N: 217,960,834.00
'       P: 21,796,083,400.00 %
'       X: CFDD182
'       000000.0: 217960834.0
'       #.0: 217960834.0
'       00000000;(0);**Zero**: 217960834

注解

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

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

format 参数可以是任何有效的标准数字格式字符串，也可以是自定义数字格式字符串的任意组合。如果 format 等于 String.Empty 或 null，则当前 UInt64 对象的返回值使用常规格式说明符（“G”）进行格式化。如果 format 是任何其他值，该方法将引发 FormatException。

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

有关数值格式说明符的详细信息，请参阅标准数值格式字符串和自定义数字格式字符串。
有关 .NET 中格式设置支持的详细信息，请参阅格式设置类型。

返回的字符串的格式由当前区域性的 NumberFormatInfo 对象确定。根据 format 参数，此对象控制输出字符串中的符号，如组分隔符和小数点符号。若要为当前区域性以外的区域性提供格式设置信息，请调用 ToString(String, IFormatProvider) 重载。

另请参阅

适用于

ToString(String, IFormatProvider)

Source:: UInt64.cs

Source:: UInt64.cs

Source:: UInt64.cs

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

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string format, IFormatProvider provider);

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

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

参数

format: String

数字格式字符串。

provider: IFormatProvider

一个对象，该对象提供有关此实例的区域性特定格式设置信息。

String

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

实现

ToString(String, IFormatProvider)

例外

FormatException

format 参数无效。

示例

以下示例使用标准数值格式说明符和一些特定的 CultureInfo 对象显示 32 位无符号整数值。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define cultures whose formatting conventions are to be used.
      CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"),
                                 CultureInfo.CreateSpecificCulture("fr-FR"),
                                 CultureInfo.CreateSpecificCulture("es-ES") };
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"};
      ulong value = 22224021;

      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}",
                              specifier, culture.Name,
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:           22224021
//        G format using fr-FR culture:           22224021
//        G format using es-ES culture:           22224021
//
//        C format using en-US culture:     $22,224,021.00
//        C format using fr-FR culture:    22 224 021,00 €
//        C format using es-ES culture:    22.224.021,00 €
//
//       D4 format using en-US culture:           22224021
//       D4 format using fr-FR culture:           22224021
//       D4 format using es-ES culture:           22224021
//
//       E2 format using en-US culture:          2.22E+007
//       E2 format using fr-FR culture:          2,22E+007
//       E2 format using es-ES culture:          2,22E+007
//
//        F format using en-US culture:        22224021.00
//        F format using fr-FR culture:        22224021,00
//        F format using es-ES culture:        22224021,00
//
//        N format using en-US culture:      22,224,021.00
//        N format using fr-FR culture:      22 224 021,00
//        N format using es-ES culture:      22.224.021,00
//
//        P format using en-US culture: 2,222,402,100.00 %
//        P format using fr-FR culture: 2 222 402 100,00 %
//        P format using es-ES culture: 2.222.402.100,00 %
//
//       X2 format using en-US culture:            1531C95
//       X2 format using fr-FR culture:            1531C95
//       X2 format using es-ES culture:            1531C95

open System.Globalization

// Define cultures whose formatting conventions are to be used.
let cultures = 
    [| CultureInfo.CreateSpecificCulture "en-US"
       CultureInfo.CreateSpecificCulture "fr-FR"
       CultureInfo.CreateSpecificCulture "es-ES" |]
let specifiers = [| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |]
let value = 22224021uL

for specifier in specifiers do
    for culture in cultures do
        printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 18}"
    printfn ""
// The example displays the following output:
//        G format using en-US culture:           22224021
//        G format using fr-FR culture:           22224021
//        G format using es-ES culture:           22224021
//
//        C format using en-US culture:     $22,224,021.00
//        C format using fr-FR culture:    22 224 021,00 €
//        C format using es-ES culture:    22.224.021,00 €
//
//       D4 format using en-US culture:           22224021
//       D4 format using fr-FR culture:           22224021
//       D4 format using es-ES culture:           22224021
//
//       E2 format using en-US culture:          2.22E+007
//       E2 format using fr-FR culture:          2,22E+007
//       E2 format using es-ES culture:          2,22E+007
//
//        F format using en-US culture:        22224021.00
//        F format using fr-FR culture:        22224021,00
//        F format using es-ES culture:        22224021,00
//
//        N format using en-US culture:      22,224,021.00
//        N format using fr-FR culture:      22 224 021,00
//        N format using es-ES culture:      22.224.021,00
//
//        P format using en-US culture: 2,222,402,100.00 %
//        P format using fr-FR culture: 2 222 402 100,00 %
//        P format using es-ES culture: 2.222.402.100,00 %
//
//       X2 format using en-US culture:            1531C95
//       X2 format using fr-FR culture:            1531C95
//       X2 format using es-ES culture:            1531C95

Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define cultures whose formatting conventions are to be used.
      Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
                                       CultureInfo.CreateSpecificCulture("fr-FR"), _
                                       CultureInfo.CreateSpecificCulture("es-ES") }
      Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}
      Dim value As ULong = 22224021

      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}", _
                              specifier, culture.Name, _
                              value.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'        G format using en-US culture:           22224021
'        G format using fr-FR culture:           22224021
'        G format using es-ES culture:           22224021
'
'        C format using en-US culture:     $22,224,021.00
'        C format using fr-FR culture:    22 224 021,00 €
'        C format using es-ES culture:    22.224.021,00 €
'
'       D4 format using en-US culture:           22224021
'       D4 format using fr-FR culture:           22224021
'       D4 format using es-ES culture:           22224021
'
'       E2 format using en-US culture:          2.22E+007
'       E2 format using fr-FR culture:          2,22E+007
'       E2 format using es-ES culture:          2,22E+007
'
'        F format using en-US culture:        22224021.00
'        F format using fr-FR culture:        22224021,00
'        F format using es-ES culture:        22224021,00
'
'        N format using en-US culture:      22,224,021.00
'        N format using fr-FR culture:      22 224 021,00
'        N format using es-ES culture:      22.224.021,00
'
'        P format using en-US culture: 2,222,402,100.00 %
'        P format using fr-FR culture: 2 222 402 100,00 %
'        P format using es-ES culture: 2.222.402.100,00 %
'
'       X2 format using en-US culture:            1531C95
'       X2 format using fr-FR culture:            1531C95
'       X2 format using es-ES culture:            1531C95

注解

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

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

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

有关数值格式说明符的详细信息，请参阅标准数值格式字符串和自定义数字格式字符串。
有关格式设置的详细信息，请参阅格式设置类型。

provider 参数是 IFormatProvider 实现。其 GetFormat 方法返回一个 NumberFormatInfo 对象，该对象提供有关此方法返回的字符串格式的区域性特定信息。调用 ToString(String, IFormatProvider) 方法时，它将调用 provider 参数的 IFormatProvider.GetFormat 方法，并传递表示 NumberFormatInfo 类型的 Type 对象。然后，GetFormat 方法返回 NumberFormatInfo 对象，该对象提供有关设置当前 UInt64 值格式的信息，例如组分隔符符号或小数点符号。可通过三种方法使用 provider 参数向 ToString(String, IFormatProvider) 方法提供格式设置信息：

可以传递表示提供格式信息的区域性的 CultureInfo 对象。其 GetFormat 方法返回为该区域性提供数值格式信息的 NumberFormatInfo 对象。
可以传递提供数字格式信息的实际 NumberFormatInfo 对象。（它的 GetFormat 实现只是返回自己。
可以传递实现 IFormatProvider的自定义对象。其 GetFormat 方法实例化并返回提供格式信息的 NumberFormatInfo 对象。

如果 providernull，则返回的字符串的格式基于当前区域性的 NumberFormatInfo 对象。

另请参阅

Parse(String)
.NET 中的格式设置类型
如何：用前导零填充数字
示例：.NET Core WinForms 格式设置实用工具（C#）
示例：.NET Core WinForms 格式设置实用工具（Visual Basic）

适用于

通过

UInt64.ToString 方法

定义

重载

ToString()

返回

示例

注解

另请参阅

适用于

ToString(IFormatProvider)

参数

返回

实现

示例

注解

另请参阅

适用于

ToString(String)

参数

返回

例外

示例

注解

另请参阅

适用于

ToString(String, IFormatProvider)

参数

返回

实现

例外

示例

注解

另请参阅

适用于

其他资源