다음을 통해 공유


UInt32.ToString 메서드

정의

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

오버로드

ToString()

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

ToString(IFormatProvider)

지정된 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

ToString(String)

지정된 형식을 사용하여 이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

ToString(String, IFormatProvider)

지정된 형식 및 문화권별 형식 정보를 사용하여 이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

ToString()

Source:
UInt32.cs
Source:
UInt32.cs
Source:
UInt32.cs

이 인스턴스의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

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

반환

기호 또는 선행 0이 없는 0에서 9 사이의 숫자 시퀀스로 구성된 이 인스턴스 값의 문자열 표현입니다.

예제

다음 예제에서는 기본 ToString() 메서드를 사용하여 UInt32 값을 표시합니다. 또한 일부 표준 형식 지정자를 사용하여 생성된 UInt32 값의 문자열 표현도 표시합니다. 예제는 en-US 문화권의 서식 규칙을 사용하여 표시됩니다.

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
let value = 1632490u
// 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:
//       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 값의 서식을 지정합니다. 다른 형식이나 문화권을 지정하려면 다음과 같이 ToString 메서드의 다른 오버로드를 사용합니다.

형식을 사용하려면 문화권의 경우 오버로드 사용
기본("G") 형식 특정 문화권 ToString(IFormatProvider)
특정 형식 기본(현재) 문화권 ToString(String)
특정 형식 특정 문화권 ToString(String, IFormatProvider)

추가 정보

적용 대상

ToString(IFormatProvider)

Source:
UInt32.cs
Source:
UInt32.cs
Source:
UInt32.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

문화권별 서식 정보를 제공하는 개체입니다.

반환

이 인스턴스 값의 문자열 표현으로, 기호 또는 선행 0이 없는 0에서 9 사이의 숫자 시퀀스로 구성됩니다.

구현

예제

다음은 고정 문화권에 대한 형식 공급자를 포함하여 여러 형식 공급자를 사용하여 16비트 부가 정수 값의 형식을 지정하는 예제입니다. 이 예제의 출력은 형식 공급자에 관계없이 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 }; 
      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
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 = 1870924u

printfn $"  {getName ci[0],12}   {getName ci[1],12}   {getName ci[3],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
//           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 값의 서식을 지정합니다. 다른 형식 또는 현재 문화권을 지정하려면 다음과 같이 ToString 메서드의 다른 오버로드를 사용합니다.

형식을 사용하려면 문화권의 경우 오버로드 사용
기본("G") 형식 기본(현재) 문화권 ToString()
특정 형식 기본(현재) 문화권 ToString(String)
특정 형식 특정 문화권 ToString(String, IFormatProvider)

provider 매개 변수는 IFormatProvider 구현입니다. 해당 GetFormat 메서드는 문화권별 서식 지정 정보를 제공하는 NumberFormatInfo 개체를 반환합니다. 그러나 일반 숫자 형식 지정자("G")로 서식을 지정할 때는 NumberFormatInfo 속성이 사용되지 않습니다.

추가 정보

적용 대상

ToString(String)

Source:
UInt32.cs
Source:
UInt32.cs
Source:
UInt32.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

숫자 형식 문자열입니다.

반환

format지정한 이 인스턴스 값의 문자열 표현입니다.

예외

format 매개 변수가 잘못되었습니다.

예제

다음 예제에서는 각 표준 형식 문자열과 일부 사용자 지정 형식 문자열을 사용하여 부호 없는 32비트 정수 값을 표시합니다.

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
let value = 2179608u
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: 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 값의 서식을 지정합니다. 기본("G" 또는 일반) 형식을 사용하거나 다른 문화권을 지정하려면 다음과 같이 ToString 메서드의 다른 오버로드를 사용합니다.

형식을 사용하려면 문화권의 경우 오버로드 사용
기본("G") 형식 기본(현재) 문화권 ToString()
기본("G") 형식 특정 문화권 ToString(IFormatProvider)
특정 형식 특정 문화권 ToString(String, IFormatProvider)

format 매개 변수는 유효한 표준 숫자 형식 문자열또는 사용자 지정 숫자 서식 문자열의 조합이수 있습니다. format String.Empty 같거나 null경우 현재 UInt32 개체의 반환 값은 일반 형식 지정자("G")로 서식이 지정됩니다. format 다른 값이면 메서드는 FormatExceptionthrow합니다.

.NET은 다음 서식 지정 항목에서 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.

반환된 문자열의 형식은 현재 문화권의 NumberFormatInfo 개체에 의해 결정됩니다. format 매개 변수에 따라 이 개체는 출력 문자열의 그룹 구분 기호 및 소수점 기호와 같은 기호를 제어합니다. 현재 문화권 이외의 문화권에 대한 서식 정보를 제공하려면 ToString(String, IFormatProvider) 오버로드를 호출합니다.

추가 정보

적용 대상

ToString(String, IFormatProvider)

Source:
UInt32.cs
Source:
UInt32.cs
Source:
UInt32.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

이 인스턴스에 대한 문화권별 서식 정보를 제공하는 개체입니다.

반환

formatprovider지정한 이 인스턴스 값의 문자열 표현입니다.

구현

예외

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"}; 
      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
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 = 2222402

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:            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 값의 서식을 지정합니다. 기본 형식 또는 문화권 설정을 사용하려면 다음과 같이 ToString 메서드의 다른 오버로드를 사용합니다.

형식을 사용하려면 문화권의 경우 오버로드 사용
기본("G") 형식 기본(현재) 문화권 ToString()
기본("G") 형식 특정 문화권 ToString(IFormatProvider)
특정 형식 기본(현재) 문화권 ToString(String)

format 매개 변수는 유효한 표준 숫자 형식 문자열또는 사용자 지정 숫자 서식 문자열의 조합이수 있습니다. format String.Empty 같거나 null경우 현재 UInt32 개체의 반환 값은 일반 형식 지정자("G")로 서식이 지정됩니다. format 다른 값이면 메서드는 FormatExceptionthrow합니다.

.NET은 다음 서식 지정 항목에서 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.

provider 매개 변수는 IFormatProvider 구현입니다. 해당 GetFormat 메서드는 이 메서드에서 반환된 문자열의 형식에 대한 문화권별 정보를 제공하는 NumberFormatInfo 개체를 반환합니다. ToString(String, IFormatProvider) 메서드가 호출되면 provider 매개 변수의 IFormatProvider.GetFormat 메서드를 호출하고 NumberFormatInfo 형식을 나타내는 Type 개체를 전달합니다. 그런 다음 GetFormat 메서드는 그룹 구분 기호 또는 소수점 기호와 같이 현재 UInt32 값의 서식을 지정하는 정보를 제공하는 NumberFormatInfo 개체를 반환합니다. provider 매개 변수를 사용하여 ToString(String, IFormatProvider) 메서드에 서식 정보를 제공하는 세 가지 방법이 있습니다.

  • 서식 정보를 제공하는 문화권을 나타내는 CultureInfo 개체를 전달할 수 있습니다. 해당 GetFormat 메서드는 해당 문화권에 대한 숫자 서식 정보를 제공하는 NumberFormatInfo 개체를 반환합니다.

  • 숫자 서식 정보를 제공하는 실제 NumberFormatInfo 개체를 전달할 수 있습니다. (GetFormat 구현은 그 자체를 반환합니다.)

  • IFormatProvider구현하는 사용자 지정 개체를 전달할 수 있습니다. 해당 GetFormat 메서드는 서식 정보를 제공하는 NumberFormatInfo 개체를 인스턴스화하고 반환합니다.

provider null경우 반환된 문자열의 서식은 현재 문화권의 NumberFormatInfo 개체를 기반으로 합니다.

추가 정보

적용 대상