BigInteger.ToString BigInteger.ToString BigInteger.ToString BigInteger.ToString Method

정의

현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object to its equivalent string representation.

오버로드

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

현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object to its equivalent string representation.

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

지정된 문화권별 서식 지정 정보를 사용하여 현재 BigInteger 개체의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

지정된 서식을 사용하여 현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

지정된 형식 및 문화권별 형식 정보를 사용하여 현재 BigInteger 개체의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format and culture-specific format information.

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

현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object 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

반환

현재 BigInteger 값의 문자열 표현입니다.The string representation of the current BigInteger value.

예제

다음 예제에서는 표시 된 BigInteger 기본값을 사용 하 여 값 ToString() 메서드.The following example displays a BigInteger value by using the default ToString() method. 또한의 문자열 표현을 표시 합니다 BigInteger 일부 표준 서식 지정자를 사용 하 여 얻은 값.It also displays the string representations of the BigInteger value that results from using some standard format specifiers. 예제에서는 EN-US 문화권의 서식 규칙을 사용 하 여 표시 됩니다.The examples are displayed using the formatting conventions of the en-US culture.

// 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" 또는 왕복을 현재 문화권의 형식입니다.The ToString() method formats a BigInteger value in the "R", or round-trip, format 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
Round-trip ("R") 형식Round-trip ("R") format 특정 문화권A specific culture ToString
특정 형식A specific format 기본 (현재) 문화권Default (current) culture ToString(String)
특정 형식A specific format 특정 문화권A specific culture ToString(String, IFormatProvider)

문자열 표현 된 BigInteger 값 앞에 오는 0 없이 0에서 9 까지의 숫자 시퀀스와 음수 값이 음수 기호가 포함 되어 있습니다.The string representation of the BigInteger value includes a negative sign if its value is negative, and a sequence of digits ranging from 0 to 9 without leading zeros. 음수 기호를 정의한는 NumberFormatInfo 현재 문화권에 대 한 개체입니다.The negative sign is defined by the NumberFormatInfo object for the current culture.

추가 정보

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

지정된 문화권별 서식 지정 정보를 사용하여 현재 BigInteger 개체의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting 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.

반환

provider 매개 변수로 지정된 서식에 따른 현재 BigInteger 값의 문자열 표현입니다.The string representation of the current BigInteger value in the format specified by the provider parameter.

예제

다음 예제에서는 사용자 지정을 인스턴스화하고 NumberFormatInfo 음수 부호로 물결표 (~)를 정의 하는 개체입니다.The following example instantiates a custom NumberFormatInfo object that defines the tilde (~) as a negative sign. 합니다 ToString(IFormatProvider) 메서드 사용 하 여 사용자 지정 NumberFormatInfo 음수를 표시할 개체 BigInteger 값입니다.The ToString(IFormatProvider) method then uses the custom NumberFormatInfo object to display a negative BigInteger value.

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

설명

합니다 ToString(IFormatProvider) 메서드 형식을 BigInteger 값 "R" 또는 왕복에서 사용 하 여 서식을 NumberFormatInfo 지정된 된 문화권의 개체입니다.The ToString(IFormatProvider) method formats a BigInteger value in the "R", or round-trip, 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
Round-trip ("R") 형식Round-trip ("R") 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 information about the format of the string returned by this method. 경우 provider 됩니다 nullBigInteger 값을 사용 하 여 형식이 NumberFormatInfo 현재 문화권의 개체입니다.If provider is null, the BigInteger value is formatted using the NumberFormatInfo object of the current culture. 유일한 속성을 NumberFormatInfo 의 문자열 표현을 제어 하는 개체를 BigInteger 일반 서식 지정자를 사용 하 여 값이 NumberFormatInfo.NegativeSign, 음수 기호를 나타내는 문자를 정의 하는.The only property of the NumberFormatInfo object that controls the string representation of the BigInteger value using the general format specifier is NumberFormatInfo.NegativeSign, which defines the character that represents the negative sign.

provider 매개 변수는 다음 중 하나일 수 있습니다.The provider parameter can be one of the following:

ToString(String) ToString(String) ToString(String) ToString(String)

지정된 서식을 사용하여 현재 BigInteger 개체의 숫자 값을 해당하는 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object to its equivalent string representation by 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 standard or custom numeric format string.

반환

format 매개 변수로 지정된 서식에 따른 현재 BigInteger 값의 문자열 표현입니다.The string representation of the current BigInteger value in the format specified by the format parameter.

예외

format은 유효한 서식 문자열이 아닙니다.format is not a valid format string.

예제

다음 예제에서는 초기화를 BigInteger 값 및 각 표준 형식 문자열 및 일부 사용자 지정 형식 문자열을 사용 하 여 표시 합니다.The following example initializes a BigInteger value and displays it by using each standard format string and some custom format strings.

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)

설명

합니다 ToString(String) 메서드 형식을 BigInteger 사용 하 여 지정 된 형식으로 값을 NumberFormatInfo 현재 문화권의 규칙을 나타내는 개체입니다.The ToString(String) method formats a BigInteger value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. "R" 또는 라운드트립 사용 하려는 경우 형식 또는 다른 문화권을 지정, 다른 오버 로드를 사용 하 여는 ToString 메서드를 다음과 같이 합니다.If you want to use the "R", or round-trip, format or specify a different culture, use the other overloads of the ToString method, as follows:

형식을 사용 하려면To use format 문화권에 대 한For culture 오버 로드를 사용 합니다.Use the overload
Round-trip ("R") 형식Round-trip ("R") format 기본 (현재) 문화권Default (current) culture ToString()
Round-trip ("R") 형식Round-trip ("R") 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 string, or any combination of custom numeric format strings. 경우 format 값과 같음 String.Empty 아니거나 null, 현재의 반환 값 BigInteger 개체 라운드트립 서식 지정자 ("R")로 포맷 된 합니다.If format is equal to String.Empty or is null, the return value of the current BigInteger object is formatted with the round-trip format specifier ("R"). 하는 경우 format 다른 값을 메서드가 throw를 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 negative sign, 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(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

지정된 형식 및 문화권별 형식 정보를 사용하여 현재 BigInteger 개체의 숫자 값을 해당 문자열 표현으로 변환합니다.Converts the numeric value of the current BigInteger object to its equivalent string representation by 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 standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

반환

formatprovider 매개 변수로 지정된 현재 BigInteger 값의 문자열 표현입니다.The string representation of the current BigInteger value as specified by the format and provider parameters.

구현

예외

format은 유효한 서식 문자열이 아닙니다.format is not a valid format string.

예제

다음 예제에서는 초기화 된 BigInteger 값을 표준 형식 문자열을 사용 하 여 콘솔에 표시 및 NumberFormatInfo 음수 부호로 물결표 (~)를 정의 하는 개체입니다.The following example initializes a BigInteger value, and displays it to the console using a standard format string and a NumberFormatInfo object that defines the tilde (~) as a negative sign.

// 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 지정된 된 문화권의 개체입니다.The ToString(String, IFormatProvider) method formats a BigInteger value in a specified format by using the NumberFormatInfo object of a specified culture. 다른 오버 로드를 사용 하 여 라운드 트립 형식 또는 기본 문화권 설정을 사용 하려는 경우는 ToString 같이 메서드:If you want to use the round-trip format or default culture settings, use the other overloads of the ToString method, as follows:

형식을 사용 하려면To use format 문화권에 대 한For culture 오버 로드를 사용 합니다.Use the overload
Round-trip ("R") 형식Round-trip ("R") format 기본 (현재) 문화권Default (current) culture ToString()
Round-trip ("R") 형식Round-trip ("R") format 특정 문화권A specific culture ToString(IFormatProvider)
특정 형식A specific format 기본 (현재) 문화권Default (current) culture ToString(String)

format 매개 변수는 유효한 수 있습니다 표준 숫자 문자열, 또는의 임의 조합 사용자 지정 숫자 서식 문자열합니다.The format parameter can be any valid standard numeric string, or any combination of custom numeric format strings. 경우 format 값과 같음 String.Empty 아니거나 null, 현재의 반환 값 BigInteger 개체 라운드트립 서식 지정자 ("R")로 포맷 된 합니다.If format is equal to String.Empty or is null, the return value of the current BigInteger object is formatted with the round-trip format specifier ("R"). 하는 경우 format 다른 값을 메서드가 throw를 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:

합니다 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 매개 변수의 GetFormat 메서드 전달를 Type 나타내는 개체를 NumberFormatInfo 형식.When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's GetFormat method and passes it a Type object that represents the NumberFormatInfo type. GetFormat 메서드가 반환 됩니다 합니다 NumberFormatInfo 서식 지정에 대 한 정보를 제공 하는 개체는 value 소수점 기호가 음수 기호, 그룹 구분 기호 등의 매개 변수입니다.The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the value parameter, such as the negative sign symbol, 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.

추가 정보

적용 대상