UInt64.ToString Method

Definition

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of this instance to its equivalent string representation.

Overloads

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:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
public:
 System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parameters

provider
IFormatProvider

문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information.

Returns

String

부호나 앞에 오는 0 없이 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.

Implements

Examples

다음 예제에서는 고정 문화권에 대 한 포함 하 여 여러 서식 공급자를 사용 하 여 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

Remarks

ToString(IFormatProvider) 메서드는 지정 된 문화권의 NumberFormatInfo 개체를 사용 하 여 기본값 ("G" 또는 일반) 형식으로 UInt64 값의 서식을 지정 합니다.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)

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").

See also

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

Parameters

format
String

숫자 서식 문자열입니다.A numeric format string.

provider
IFormatProvider

이 인스턴스에 대한 문화권별 서식 지정 정보를 제공하는 개체입니다.An object that supplies culture-specific formatting information about this instance.

Returns

String

formatprovider로 지정된 이 인스턴스 값의 문자열 표현입니다.The string representation of the value of this instance as specified by format and provider.

Implements

Exceptions

format 매개 변수가 잘못된 경우The format parameter is invalid.

Examples

다음 예제에서는 표준 숫자 서식 지정자와 여러 특정 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

Remarks

ToString(String, IFormatProvider) 메서드는 지정 된 문화권의 NumberFormatInfo 개체를 사용 하 여 지정 된 형식으로 UInt64 값의 형식을 지정 합니다.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)

format 매개 변수는 임의의 유효한 표준 숫자 형식 문자열또는 사용자 지정 숫자 형식 문자열의 조합일 수 있습니다.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. format String.Empty와 같거나 null경우 현재 UInt64 개체의 반환 값은 일반 형식 지정자 ("G")로 형식이 지정 됩니다.If 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를 throw 합니다.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:

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 메서드는 그룹 구분 기호 또는 소수점 기호와 같은 현재 UInt64 값의 서식을 지정 하기 위한 정보를 제공 하는 NumberFormatInfo 개체를 반환 합니다.The 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:

  • 서식 지정 정보를 제공 하는 문화권을 나타내는 CultureInfo 개체를 전달할 수 있습니다.You can pass a CultureInfo object that represents the culture that supplies formatting information. 해당 GetFormat 메서드는 해당 문화권에 대 한 숫자 형식 지정 정보를 제공 하는 NumberFormatInfo 개체를 반환 합니다.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • 숫자 형식 지정 정보를 제공 하는 실제 NumberFormatInfo 개체를 전달할 수 있습니다.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (GetFormat의 구현은 자신을 반환 하기만 합니다.)(Its implementation of GetFormat just returns itself.)

  • IFormatProvider를 구현 하는 사용자 지정 개체를 전달할 수 있습니다.You can pass a custom object that implements IFormatProvider. GetFormat 메서드는 형식 지정 정보를 제공 하는 NumberFormatInfo 개체를 인스턴스화하고 반환 합니다.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

provider null경우 반환 되는 문자열의 형식은 현재 문화권의 NumberFormatInfo 개체를 기반으로 합니다.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

See also

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

Parameters

format
String

숫자 서식 문자열입니다.A numeric format string.

Returns

String

이 인스턴스의 값을 format에 지정된 내용에 따라 나타낸 문자열 표현입니다.The string representation of the value of this instance as specified by format.

Exceptions

format 매개 변수가 잘못된 경우The format parameter is invalid.

Examples

다음 예제에서는 각 표준 형식 문자열 및 일부 사용자 지정 형식 문자열을 사용 하 여 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

Remarks

ToString(String) 메서드는 현재 문화권의 규칙을 나타내는 NumberFormatInfo 개체를 사용 하 여 지정 된 형식으로 UInt64 값의 형식을 지정 합니다.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)

format 매개 변수는 임의의 유효한 표준 숫자 형식 문자열또는 사용자 지정 숫자 형식 문자열의 조합일 수 있습니다.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. format String.Empty와 같거나 null경우 현재 UInt64 개체의 반환 값은 일반 형식 지정자 ("G")로 형식이 지정 됩니다.If 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를 throw 합니다.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.

See also

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

Returns

String

부호나 앞에 오는 0 없이 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.

Examples

다음 예제에서는 기본 ToString() 메서드를 사용 하 여 UInt64 값을 표시 합니다.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

Remarks

ToString() 메서드는 현재 문화권의 NumberFormatInfo 개체를 사용 하 여 기본값 ("G" 또는 일반) 형식으로 UInt64 값의 서식을 지정 합니다.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)

See also

Applies to