UInt32.ToString 方法

定義

命名空間:

System

組件:

System.Runtime.dll

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

多載

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

ToString()

來源:

UInt32.cs

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

C#

public override string ToString ();

傳回

String

這個實例值的字串表示，包含介於 0 到 9 的數位序列，不含符號或前置零。

範例

下列範例會使用預設 ToString() 方法來顯示 UInt32 值。 它也會顯示使用某些標準格式規範所產生的 UInt32 值的字串表示。 這些範例會使用 en-US 文化特性的格式設定慣例來顯示。

C#

using System;

public class Example
{
   public static void Main()
   {
      uint value = 1632490;
      // 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:
//       1632490
//       
//       G format specifier:          1632490
//       C format specifier:    $1,632,490.00
//       D format specifier:          1632490
//       F format specifier:       1632490.00
//       N format specifier:     1,632,490.00
//       X format specifier:           18E8EA

備註

ToString() 方法會使用目前文化特性的 NumberFormatInfo 物件，以預設 （“G” 或一般） 格式格式化 UInt32 值。 如果您想要指定不同的格式或文化特性，請使用 ToString 方法的其他多載，如下所示：

使用格式	針對文化特性	使用多載
預設值 （“G”） 格式	特定文化特性	ToString(IFormatProvider)
特定格式	預設 （目前） 文化特性	ToString(String)
特定格式	特定文化特性	ToString(String, IFormatProvider)

另請參閱

• Parse(String)
• .NET 中的格式設定類型

ToString(IFormatProvider)

來源:

UInt32.cs

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

C#

public string ToString (IFormatProvider? provider);

參數

provider

IFormatProvider

物件，提供特定文化特性的格式資訊。

傳回

String

這個實例值的字串表示，包含介於 0 到 9 的數位序列，不含符號或前置零。

實作

ToString(IFormatProvider)

範例

下列範例會使用數個格式提供者來格式化 16 位帶正負號的整數值，包括一個不因文化特性而異。 此範例的輸出說明不論格式提供者為何，ToString(IFormatProvider) 方法所傳回的格式化字串都相同。

C#

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 }; 
      uint value = 1870924;
      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
//           1870924        1870924        1870924

備註

ToString(IFormatProvider) 方法會使用指定文化特性的 NumberFormatInfo 物件，將預設 （“G” 或一般） 格式的 UInt32 值格式化。 如果您想要指定不同的格式或目前的文化特性，請使用 ToString 方法的其他多載，如下所示：

使用格式	針對文化特性	使用多載
預設值 （“G”） 格式	預設 （目前） 文化特性	ToString()
特定格式	預設 （目前） 文化特性	ToString(String)
特定格式	特定文化特性	ToString(String, IFormatProvider)

provider 參數是 IFormatProvider 實作。 其 GetFormat 方法會傳回提供特定文化特性格式資訊的 NumberFormatInfo 物件。 不過，使用一般數值格式規範 （“G” 格式化時，不會使用 NumberFormatInfo 的屬性。

另請參閱

• Parse(String)
• .NET 中的格式設定類型

ToString(String)

來源:

UInt32.cs

使用指定的格式，將這個實例的數值轉換為其相等字串表示。

C#

public string ToString (string? format);

參數

format

String

數值格式字串。

傳回

String

這個實例值的字串表示，如 format所指定。

例外狀況

FormatException

format 參數無效。

範例

下列範例會使用每個標準格式字串和一些自定義格式字串，顯示32位無符號整數值。

C#

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      uint value = 2179608;
      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: 2179608
//       C: $2,179,608.00
//       D3: 2179608
//       E2: 2.18E+006
//       e3: 2.180e+006
//       F: 2179608.00
//       N: 2,179,608.00
//       P: 217,960,800.00 %
//       X: 214218
//       000000.0: 2179608.0
//       #.0: 2179608.0
//       00000000;(0);**Zero**: 02179608

備註

ToString(String) 方法會使用代表目前文化特性慣例的 NumberFormatInfo 物件，以指定格式格式化 UInt32 值。 如果您想要使用預設 （“G” 或一般） 格式或指定不同的文化特性，請使用 ToString 方法的其他多載，如下所示：

使用格式	針對文化特性	使用多載
預設值 （“G”） 格式	預設 （目前） 文化特性	ToString()
預設值 （“G”） 格式	特定文化特性	ToString(IFormatProvider)
特定格式	特定文化特性	ToString(String, IFormatProvider)

format 參數可以是任何有效的 標準數值格式字串，或 自定義數值格式字串的任何組合。 如果 format 等於 String.Empty 或 null，則目前 UInt32 對象的傳回值會以一般格式規範 （“G” ） 格式化。 如果 format 為任何其他值，方法會擲回 FormatException。

.NET 提供廣泛的格式支援，如下列格式化主題中更詳細地說明：

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自定義數值格式字串。

• 如需 .NET 中格式化支援的詳細資訊，請參閱 格式化類型。

傳回字串的格式是由目前文化特性的 NumberFormatInfo 對象所決定。 視 format 參數而定，這個物件會控制輸出字串中的群組分隔符和小數點符號等符號。 若要提供目前文化特性以外的文化特性的格式資訊，請呼叫 ToString(String, IFormatProvider) 多載。

另請參閱

• Parse(String)
• .NET 中的格式設定類型
• 作法：使用前置零填補數位，

ToString(String, IFormatProvider)

來源:

UInt32.cs

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

C#

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

參數

format

String

數值格式字串。

provider

IFormatProvider

物件，提供這個實例的文化特性特定格式資訊。

傳回

String

這個實例值的字串表示，如 format 和 provider所指定。

實作

ToString(String, IFormatProvider)

例外狀況

FormatException

format 參數無效。

範例

下列範例會使用標準數值格式規範和一些特定的 CultureInfo 對象，來顯示32位無符號整數值。

C#

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"}; 
      uint value = 2222402;
      
      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:            2222402
//        G format using fr-FR culture:            2222402
//        G format using es-ES culture:            2222402
//       
//        C format using en-US culture:      $2,222,402.00
//        C format using fr-FR culture:     2 222 402,00 €
//        C format using es-ES culture:     2.222.402,00 €
//       
//       D4 format using en-US culture:            2222402
//       D4 format using fr-FR culture:            2222402
//       D4 format using es-ES culture:            2222402
//       
//       E2 format using en-US culture:          2.22E+006
//       E2 format using fr-FR culture:          2,22E+006
//       E2 format using es-ES culture:          2,22E+006
//       
//        F format using en-US culture:         2222402.00
//        F format using fr-FR culture:         2222402,00
//        F format using es-ES culture:         2222402,00
//       
//        N format using en-US culture:       2,222,402.00
//        N format using fr-FR culture:       2 222 402,00
//        N format using es-ES culture:       2.222.402,00
//       
//        P format using en-US culture:   222,240,200.00 %
//        P format using fr-FR culture:   222 240 200,00 %
//        P format using es-ES culture:   222.240.200,00 %
//       
//       X2 format using en-US culture:             21E942
//       X2 format using fr-FR culture:             21E942
//       X2 format using es-ES culture:             21E942

備註

ToString(String, IFormatProvider) 方法會使用指定文化特性的 NumberFormatInfo 物件，以指定格式格式化 UInt32 值。 如果您想要使用預設格式或文化特性設定，請使用 ToString 方法的其他多載，如下所示：

使用格式	針對文化特性	使用多載
預設值 （“G”） 格式	預設 （目前） 文化特性	ToString()
預設值 （“G”） 格式	特定文化特性	ToString(IFormatProvider)
特定格式	預設 （目前） 文化特性	ToString(String)

format 參數可以是任何有效的 標準數值格式字串，或 自定義數值格式字串的任何組合。 如果 format 等於 String.Empty 或 null，則目前 UInt32 對象的傳回值會以一般格式規範 （“G” ） 格式化。 如果 format 為任何其他值，方法會擲回 FormatException。

.NET 提供廣泛的格式支援，如下列格式化主題中更詳細地說明：

• 如需數值格式規範的詳細資訊，請參閱 標準數值格式字串 和 自定義數值格式字串。

• 如需格式化的詳細資訊，請參閱 格式化類型。

provider 參數是 IFormatProvider 實作。 其 GetFormat 方法會傳回 NumberFormatInfo 物件，提供這個方法所傳回之字串格式的文化特性特定資訊。 叫用 ToString(String, IFormatProvider) 方法時，它會呼叫 provider 參數的 IFormatProvider.GetFormat 方法，並傳遞代表 NumberFormatInfo 類型的 Type 物件。 然後，GetFormat 方法會傳回 NumberFormatInfo 物件，以提供格式化目前 UInt32 值的資訊，例如群組分隔符符號或小數點符號。 有三種方式可以使用 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）