BigInteger.ToString 메서드

정의

현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

오버로드

ToString(String, IFormatProvider)

지정된 형식 및 문화권별 형식 정보를 사용하여 현재 BigInteger 개체의 숫자 값을 해당 문자열 표현으로 변환합니다.

ToString(String)

지정된 서식을 사용하여 현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

ToString(IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여 현재 BigInteger 개체의 숫자 값을 해당 문자열 표현으로 변환합니다.

ToString()

현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

ToString(String, IFormatProvider)

지정된 형식 및 문화권별 형식 정보를 사용하여 현재 BigInteger 개체의 숫자 값을 해당 문자열 표현으로 변환합니다.

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 매개 변수로 지정된 현재 BigInteger 값의 문자열 표현입니다.

구현

예외

format은 유효한 서식 문자열이 아닙니다.

예제

다음 예제에서는 값을 초기화 BigInteger 하고 표준 형식 문자열과 NumberFormatInfo 타일(~)을 음수 기호로 정의하는 개체를 사용하여 콘솔에 표시합니다.

// Redefine the negative sign as the tilde for the invariant culture.
NumberFormatInfo bigIntegerFormatter = new NumberFormatInfo();
bigIntegerFormatter.NegativeSign = "~";

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0",
                        "G", "N0", "P", "R", "X", "0,0.000",
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier,
                     bigIntegerFormatter));

// The example displays the following output:
//    C: (☼903,145,792,771,643,190,182.00)
//    D: ~903145792771643190182
//    D25: ~0000903145792771643190182
//    E: ~9.031457E+020
//    E4: ~9.0314E+020
//    e8: ~9.03145792e+020
//    F0: ~903145792771643190182
//    G: ~903145792771643190182
//    N0: ~903,145,792,771,643,190,182
//    P: ~90,314,579,277,164,319,018,200.00 %
//    R: ~903145792771643190182
//    X: CF0A55968BB1A7545A
//    0,0.000: ~903,145,792,771,643,190,182.000
//    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)
' Redefine the negative sign as the tilde for the invariant culture.
Dim bigIntegerFormatter As New NumberFormatInfo()
bigIntegerFormatter.NegativeSign = "~"

Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier, 
                     bigIntegerformatter))
Next   
' The example displays the following output:
'    C: (☼903,145,792,771,643,190,182.00)
'    D: ~903145792771643190182
'    D25: ~0000903145792771643190182
'    E: ~9.031457E+020
'    E4: ~9.0314E+020
'    e8: ~9.03145792e+020
'    F0: ~903145792771643190182
'    G: ~903145792771643190182
'    N0: ~903,145,792,771,643,190,182
'    P: ~90,314,579,277,164,319,018,200.00 %
'    R: ~903145792771643190182
'    X: CF0A55968BB1A7545A
'    0,0.000: ~903,145,792,771,643,190,182.000
'    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

설명

메서드는 ToString(String, IFormatProvider)BigInteger 지정된 문화권의 개체를 사용하여 NumberFormatInfo 지정된 형식의 값 형식을 지정합니다. 왕복 형식 또는 기본 문화권 설정을 사용하려면 다음과 같이 메서드의 ToString 다른 오버로드를 사용합니다.

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

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

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

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

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

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

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

가 이nullprovider 반환된 문자열의 서식은 현재 문화권 NumberFormatInfo 의 개체를 기반으로 합니다.

추가 정보

적용 대상

ToString(String)

지정된 서식을 사용하여 현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

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 매개 변수로 지정된 서식에 따른 현재 BigInteger 값의 문자열 표현입니다.

예외

format은 유효한 서식 문자열이 아닙니다.

예제

다음 예제에서는 값을 초기화 BigInteger 하고 각 표준 형식 문자열과 일부 사용자 지정 형식 문자열을 사용하여 값을 표시합니다.

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0",
                        "G", "N0", "P", "R", "X", "0,0.000",
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));

// The example displays the following output:
//       C: ($903,145,792,771,643,190,182.00)
//       D: -903145792771643190182
//       D25: -0000903145792771643190182
//       E: -9.031457E+020
//       E4: -9.0314E+020
//       e8: -9.03145792e+020
//       F0: -903145792771643190182
//       G: -903145792771643190182
//       N0: -903,145,792,771,643,190,182
//       P: -90,314,579,277,164,319,018,200.00 %
//       R: -903145792771643190182
//       X: CF0A55968BB1A7545A
//       0,0.000: -903,145,792,771,643,190,182.000
//       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)
Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next   
' The example displays the following output:
'       C: ($903,145,792,771,643,190,182.00)
'       D: -903145792771643190182
'       D25: -0000903145792771643190182
'       E: -9.031457E+020
'       E4: -9.0314E+020
'       e8: -9.03145792e+020
'       F0: -903145792771643190182
'       G: -903145792771643190182
'       N0: -903,145,792,771,643,190,182
'       P: -90,314,579,277,164,319,018,200.00 %
'       R: -903145792771643190182
'       X: CF0A55968BB1A7545A
'       0,0.000: -903,145,792,771,643,190,182.000
'       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

설명

메서드 BigIntegerToString(String) 현재 문화권의 규칙을 나타내는 개체를 NumberFormatInfo 사용하여 지정된 형식의 값 형식을 지정합니다. "R"을 사용하거나 왕복을 사용하거나 다른 문화권을 포맷하거나 지정하려면 다음과 같이 메서드의 ToString 다른 오버로드를 사용합니다.

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

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

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

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

추가 정보

적용 대상

ToString(IFormatProvider)

지정된 문화권별 서식 지정 정보를 사용하여 현재 BigInteger 개체의 숫자 값을 해당 문자열 표현으로 변환합니다.

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

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

반환

provider 매개 변수로 지정된 서식에 따른 현재 BigInteger 값의 문자열 표현입니다.

예제

다음 예제에서는 타일(~)을 음수 기호로 정의하는 사용자 지정 NumberFormatInfo 개체를 인스턴스화합니다. 그런 다음 메서드는 ToString(IFormatProvider) 사용자 지정 NumberFormatInfo 개체를 사용하여 음 BigInteger 수 값을 표시합니다.

BigInteger number = 9867857831128;
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne;

NumberFormatInfo bigIntegerProvider = new NumberFormatInfo();
bigIntegerProvider.NegativeSign = "~";

Console.WriteLine(number.ToString(bigIntegerProvider));
Dim number As BigInteger = 9867857831128
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

Dim bigIntegerProvider As New NumberFormatInfo()
bigIntegerProvider.NegativeSign = "~"      

Console.WriteLine(number.ToString(bigIntegerProvider))

설명

메서드 BigIntegerToString(IFormatProvider) 지정된 문화권의 개체를 사용하여 NumberFormatInfo "R" 또는 왕복 형식의 값 형식을 지정합니다. 다른 형식 또는 현재 문화권을 지정하려면 다음과 같이 메서드의 ToString 다른 오버로드를 사용합니다.

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

매개 변수는 provider 구현입니다 IFormatProvider . 해당 메서드는 GetFormat 이 메서드에서 NumberFormatInfo 반환된 문자열의 형식에 대한 문화권별 정보를 제공하는 개체를 반환합니다. 이 이nullprovider 값은 BigInteger 현재 문화권의 개체를 NumberFormatInfo 사용하여 서식이 지정됩니다. 일반 형식 지정자를 사용하여 값의 문자열 표현을 제어하는 개체의 NumberFormatInfoBigInteger 유일한 속성은 음수 기호를 나타내는 문자를 정의하는 입니다 NumberFormatInfo.NegativeSign.

매개 변수는 provider 다음 중 하나일 수 있습니다.

적용 대상

ToString()

현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.

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

반환

현재 BigInteger 값의 문자열 표현입니다.

예제

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

// Initialize a BigInteger value.
BigInteger value = BigInteger.Add(UInt64.MaxValue, 1024);

// Display value using the default ToString method.
Console.WriteLine(value.ToString());
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));
Console.WriteLine(value.ToString("C"));
Console.WriteLine(value.ToString("D"));
Console.WriteLine(value.ToString("F"));
Console.WriteLine(value.ToString("N"));
Console.WriteLine(value.ToString("X"));
// The example displays the following output on a system whose current
// culture is en-US:
//       18446744073709552639
//       18446744073709552639
//       $18,446,744,073,709,552,639.00
//       18446744073709552639
//       18446744073709552639.00
//       18,446,744,073,709,552,639.00
//       100000000000003FF
' Initialize a BigInteger value.
Dim value As BigInteger = BigInteger.Add(UInt64.MaxValue, 1024)

' Display value using the default ToString method.
Console.WriteLine(value.ToString())        
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))
Console.WriteLine(value.ToString("C"))
Console.WriteLine(value.ToString("D"))
Console.WriteLine(value.ToString("F"))
Console.WriteLine(value.ToString("N"))
Console.WriteLine(value.ToString("X"))       
' The example displays the following output on a system whose current 
' culture is en-US:
'       18446744073709552639
'       18446744073709552639
'       $18,446,744,073,709,552,639.00
'       18446744073709552639
'       18446744073709552639.00
'       18,446,744,073,709,552,639.00
'       100000000000003FF

설명

메서드는 ToString()BigInteger 현재 문화권의 "R" 또는 왕복 형식의 값 형식을 지정합니다. 다른 형식이나 문화권을 지정하려면 다음과 같이 메서드의 ToString 다른 오버로드를 사용합니다.

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

값의 문자열 표현에는 해당 값이 BigInteger 음수이면 음수 기호가 포함되고 앞에 오는 0이 없는 0에서 9까지의 숫자 시퀀스가 포함됩니다. 음수 기호는 현재 문화권에 NumberFormatInfo 대한 개체에 의해 정의됩니다.

추가 정보

적용 대상