UInt32.ToString 方法

定義

將這個執行個體的數值轉換為它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation.

多載

ToString(IFormatProvider)

使用指定的特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

使用指定的格式和特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String)

使用指定的格式,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format.

ToString()

將這個執行個體的數值轉換為它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

使用指定的特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public:
 System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

參數

provider
IFormatProvider

物件,提供特定文化特性格式資訊。An object that supplies culture-specific formatting information.

傳回

這個執行個體值的字串表示,由 0 到 9 的數字順序所組成,沒有正負號或為零的前置字元。The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

實作

範例

下列範例會使用數個格式提供者來格式化16位帶正負號的整數值,包括一個用於不因文化特性而異。The following example formats a 16-bit signed integer value by using several format providers, including one for the invariant culture. 範例的輸出說明,不論格式提供者為何,ToString(IFormatProvider) 方法所傳回的格式化字串都相同。The output from the example illustrates that the formatted string returned by the ToString(IFormatProvider) method is the same regardless of the format provider.

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
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 UInteger = 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)))            
      
   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
'      1870924        1870924        1870924

備註

ToString(IFormatProvider) 方法會使用指定文化特性的 NumberFormatInfo 物件,以預設("G" 或一般)格式來格式化 UInt32 值。The ToString(IFormatProvider) method formats a UInt32 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. 如果您想要指定不同的格式或目前的文化特性,請使用 ToString 方法的其他多載,如下所示:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

若要使用格式To use format 針對文化特性For culture 使用多載Use the overload
預設值("G")格式Default ("G") format 預設(目前)文化特性Default (current) culture ToString()
特定格式A specific format 預設(目前)文化特性Default (current) culture ToString(String)
特定格式A specific format 特定文化特性A specific culture ToString(String, IFormatProvider)

provider 參數是 IFormatProvider 的實作為。The provider parameter is an IFormatProvider implementation. GetFormat 方法會傳回提供特定文化特性格式資訊的 NumberFormatInfo 物件。Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. 不過,使用一般數值格式規範("G")進行格式化時,不會使用 NumberFormatInfo 的任何屬性。However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

另請參閱

ToString(String, IFormatProvider)

使用指定的格式和特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::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

數值格式字串。A numeric format string.

provider
IFormatProvider

物件,提供關於這個執行個體的文化特性格式資訊。An object that supplies culture-specific formatting information about this instance.

傳回

這個執行個體值的字串表示,如同 formatprovider 所指定。The string representation of the value of this instance as specified by format and provider.

實作

例外狀況

format 參數無效。The format parameter is invalid.

範例

下列範例會使用標準數值格式規範和一些特定 CultureInfo 物件來顯示32位不帶正負號的整數值。The following example displays a 32-bit unsigned integer value by using the standard numeric format specifiers and a number of specific CultureInfo objects.

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
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 UInteger = 2222402
      
      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:            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 的值。The ToString(String, IFormatProvider) method formats a UInt32 value in a specified format by using the NumberFormatInfo object of a specified culture. 如果您想要使用預設格式或文化特性設定,請使用 ToString 方法的其他多載,如下所示:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

若要使用格式To use format 針對文化特性For culture 使用多載Use the overload
預設值("G")格式Default ("G") format 預設(目前)文化特性Default (current) culture ToString()
預設值("G")格式Default ("G") format 特定文化特性A specific culture ToString(IFormatProvider)
特定格式A specific format 預設(目前)文化特性Default (current) culture ToString(String)

format 參數可以是任何有效的標準數值格式字串,或是自訂數值格式字串的任何組合。The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. 如果 format 等於 String.Emptynull,則會使用一般格式規範("G")來格式化目前 UInt32 物件的傳回值。If format is equal to String.Empty or is null, the return value of the current UInt32 object is formatted with the general format specifier ("G"). 如果 format 為任何其他值,則方法會擲回 FormatExceptionIf format is any other value, the method throws a FormatException.

.NET Framework 提供廣泛的格式設定支援,在下列格式設定主題中有更詳細的說明:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

provider 參數是 IFormatProvider 的實作為。The provider parameter is an IFormatProvider implementation. 它的 GetFormat 方法會傳回一個 NumberFormatInfo 物件,它會提供有關此方法所傳回之字串格式的特定文化特性資訊。Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. 叫用 ToString(String, IFormatProvider) 方法時,它會呼叫 provider 參數的 IFormatProvider.GetFormat 方法,並將代表 NumberFormatInfo 類型的 Type 物件傳遞給它。When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's IFormatProvider.GetFormat method and passes it a Type object that represents the NumberFormatInfo type. 然後,GetFormat 方法會傳回 NumberFormatInfo 物件,提供格式化目前 UInt32 值的資訊,例如群組分隔符號或小數點符號。The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the current UInt32 value, such as the group separator symbol or the decimal point symbol. 有三種方式可以使用 provider 參數,將格式資訊提供給 ToString(String, IFormatProvider) 方法:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

如果 null``provider,則傳回字串的格式會以目前文化特性的 NumberFormatInfo 物件為基礎。If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

另請參閱

ToString(String)

使用指定的格式,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

參數

format
String

數值格式字串。A numeric format string.

傳回

這個執行個體值的字串表示,如同 format 所指定。The string representation of the value of this instance as specified by format.

例外狀況

format 參數無效。The format parameter is invalid.

範例

下列範例會使用每個標準格式字串和一些自訂格式字串來顯示32位不帶正負號的整數值。The following example displays a 32-bit unsigned integer value by using each standard format string and some custom format strings.

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
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UInteger = 2179608 
      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: 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 值。The ToString(String) method formats a UInt32 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. 如果您想要使用預設值("G" 或一般)格式或指定不同的文化特性,請使用 ToString 方法的其他多載,如下所示:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

若要使用格式To use format 針對文化特性For culture 使用多載Use the overload
預設值("G")格式Default ("G") format 預設(目前)文化特性Default (current) culture ToString()
預設值("G")格式Default ("G") format 特定文化特性A specific culture ToString(IFormatProvider)
特定格式A specific format 特定文化特性A specific culture ToString(String, IFormatProvider)

format 參數可以是任何有效的標準數值格式字串,或是自訂數值格式字串的任何組合。The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. 如果 format 等於 String.Emptynull,則會使用一般格式規範("G")來格式化目前 UInt32 物件的傳回值。If format is equal to String.Empty or is null, the return value of the current UInt32 object is formatted with the general format specifier ("G"). 如果 format 為任何其他值,則方法會擲回 FormatExceptionIf format is any other value, the method throws a FormatException.

.NET Framework 提供廣泛的格式設定支援,在下列格式設定主題中有更詳細的說明:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

傳回字串的格式是由目前文化特性的 NumberFormatInfo 物件所決定。The format of the returned string is determined by the NumberFormatInfo object for the current culture. format 參數而定,此物件會控制符號,例如群組分隔符號和輸出字串中的小數點符號。Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. 若要提供目前文化特性以外文化特性的格式資訊,請呼叫 ToString(String, IFormatProvider) 多載。To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

另請參閱

ToString()

將這個執行個體的數值轉換為它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

傳回

這個執行個體值的字串表示,由範圍從 0 到 9,沒有正負號或為零的前置字元的數字順序所組成。The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeroes.

範例

下列範例會使用預設的 ToString() 方法來顯示 UInt32 值。The following example displays a UInt32 value by using the default ToString() method. 它也會顯示使用一些標準格式規範所產生之 UInt32 值的字串表示。It also displays the string representations of the UInt32 value that results from using some standard format specifiers. 這些範例會使用 en-us 文化特性的格式化慣例來顯示。The examples are displayed using the formatting conventions of the en-US culture.

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
Module Example
   Public Sub Main()
      Dim value As UInteger = 1632490
      ' 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:
'       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 值。The ToString() method formats a UInt32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. 如果您想要指定不同的格式或文化特性,請使用 ToString 方法的其他多載,如下所示:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

若要使用格式To use format 針對文化特性For culture 使用多載Use the overload
預設值("G")格式Default ("G") format 特定文化特性A specific culture ToString(IFormatProvider)
特定格式A specific format 預設(目前)文化特性Default (current) culture ToString(String)
特定格式A specific format 特定文化特性A specific culture ToString(String, IFormatProvider)

另請參閱

適用於