UInt64.ToString UInt64.ToString UInt64.ToString UInt64.ToString Method

定义

将此实例的数值转换为其等效的字符串表示形式。Converts the numeric value of this instance to its equivalent string representation.

重载

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

使用指定的区域性特定格式信息,将此实例的数值转换为它的等效字符串表示形式。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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) ToString(String) ToString(String) ToString(String)

使用指定的格式将此实例的数值转换为它的等效字符串表示形式。Converts the numeric value of this instance to its equivalent string representation using the specified format.

ToString() ToString() ToString() ToString()

将此实例的数值转换为其等效的字符串表示形式。Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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 IFormatProvider IFormatProvider IFormatProvider

一个提供区域性特定的格式设置信息的对象。An object that supplies culture-specific formatting information.

返回

此实例的值的字符串表示形式,由范围从 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 zeros.

实现

示例

下面的示例使用多个格式提供程序(包括一个用于固定区域性的格式提供程序)设置64位有符号整数值的格式。The following example formats a 64-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 }; 
      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
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

注解

方法使用指定区域性UInt64NumberFormatInfo对象设置默认值("G" 或 "常规")格式的值的格式。 ToString(IFormatProvider)The ToString(IFormatProvider) method formats a UInt64 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)

参数是一个IFormatProvider实现。 providerThe provider parameter is an IFormatProvider implementation. GetFormat方法返回一个NumberFormatInfo对象,该对象提供区域性特定的格式设置信息。Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. 但是,在使用一般数值格式说明符NumberFormatInfo ("G")进行格式设置时,不会使用的任何属性。However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

另请参阅

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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 String String String

一个数值格式字符串。A numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider 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"}; 
      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
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

注解

方法使用指定的UInt64区域性的NumberFormatInfo对象设置指定格式的值的格式。 ToString(String, IFormatProvider)The ToString(String, IFormatProvider) method formats a UInt64 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)

参数可以是任何有效的标准数字格式字符串,也可以是自定义数字格式字符串的任意组合。 formatThe format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. 如果format UInt64等于或为null,则当前对象的返回值用常规格式说明符("G")进行格式设置。 String.EmptyIf format is equal to String.Empty or is null, the return value of the current UInt64 object is formatted with the general format specifier ("G"). 如果format是其他任何值, 则该方法将FormatException引发。If 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:

参数是一个IFormatProvider实现。 providerThe 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. IFormatProvider.GetFormat Type NumberFormatInfo调用方法时, 它provider调用参数的方法并向其传递一个表示类型的对象。 ToString(String, IFormatProvider)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. 然后, NumberFormatInfo UInt64方法返回对象,该对象提供用于设置当前值的格式的信息,如组分隔符符号或小数点符号。 GetFormatThe GetFormat method then returns the NumberFormatInfo object that provides information for formatting the current UInt64 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:

如果provider NumberFormatInfonull, 则返回的字符串的格式基于当前区域性的对象。If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

另请参阅

ToString(String) ToString(String) ToString(String) 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 String String 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.

示例

下面的示例通过使用每个标准格式字符串和一些自定义格式字符串来显示64位无符号整数值。The following example displays a 64-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()
   {
      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
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

注解

方法使用表示当前UInt64区域性约定的NumberFormatInfo对象来设置指定格式的值的格式。 ToString(String)The ToString(String) method formats a UInt64 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)

参数可以是任何有效的标准数字格式字符串,也可以是自定义数字格式字符串的任意组合。 formatThe format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. 如果format UInt64等于或为null,则当前对象的返回值用常规格式说明符("G")进行格式设置。 String.EmptyIf format is equal to String.Empty or is null, the return value of the current UInt64 object is formatted with the general format specifier ("G"). 如果format是其他任何值, 则该方法将FormatException引发。If 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() ToString() ToString() 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.

示例

下面的示例使用默认UInt64 ToString()方法显示一个值。The following example displays a UInt64 value by using the default ToString() method. 它还显示使用某些标准格式说明符UInt64生成的值的字符串表示形式。It also displays the string representations of the UInt64 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()
   {
      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
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

注解

方法使用当前区域性UInt64NumberFormatInfo对象设置默认值("G" 或 "常规")格式的值的格式。 ToString()The ToString() method formats a UInt64 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)
另请参阅

适用于