UInt64.ToString 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將這個實例的數值轉換為其相等的字串表示。

多載

ToString()	將這個實例的數值轉換為其相等的字串表示。
ToString(IFormatProvider)	使用指定的特定文化特性格式資訊，將這個實例的數值轉換為其相等的字串表示。
ToString(String)	使用指定的格式，將這個實例的數值轉換為其相等字串表示。
ToString(String, IFormatProvider)	使用指定的格式和文化特性特定格式資訊，將這個實例的數值轉換為其相等的字串表示。

ToString()

來源:: UInt64.cs

來源:: UInt64.cs

來源:: 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)

來源:: UInt64.cs

來源:: UInt64.cs

來源:: 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)

來源:: UInt64.cs

來源:: UInt64.cs

來源:: 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)

來源:: UInt64.cs

來源:: UInt64.cs

來源:: 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)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

其他資源