BigInteger.ToString メソッド

定義

現在の BigInteger オブジェクトの数値を等価の文字列形式に変換します。Converts the numeric value of the current BigInteger object to its equivalent string representation.

オーバーロード

ToString()

現在の BigInteger オブジェクトの数値を等価の文字列形式に変換します。Converts the numeric value of the current BigInteger object to its equivalent string representation.

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)

指定された書式を使用して、現在の BigInteger オブジェクトの数値をそれと等価な文字列形式に変換します。Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format.

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

現在の 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

戻り値

String

現在の BigInteger 値の文字列形式。The string representation of the current BigInteger value.

次の例では、既定の ToString() メソッドを使用して BigInteger 値を表示します。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() メソッドは、現在のカルチャの "R" またはラウンドトリップ形式で BigInteger 値の書式を設定します。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
ラウンドトリップ ("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から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)

指定されたカルチャ固有の書式情報を使用して、現在の 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

カルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information.

戻り値

String

現在の BigInteger 値の文字列形式を、provider パラメーターで指定されている形式で表現した値。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) メソッドは、指定されたカルチャの NumberFormatInfo オブジェクトを使用して、"R" またはラウンドトリップ形式の BigInteger 値を書式設定します。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
ラウンドトリップ ("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. providernull場合、BigInteger の値は、現在のカルチャの NumberFormatInfo オブジェクトを使用して書式設定されます。If provider is null, the BigInteger value is formatted using the NumberFormatInfo object of the current culture. 一般的な書式指定子を使用して BigInteger 値の文字列形式を制御する NumberFormatInfo オブジェクトの唯一のプロパティは 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)

指定された書式を使用して、現在の 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

標準またはカスタムの数値書式指定文字列。A standard or custom numeric format string.

戻り値

String

現在の BigInteger 値の文字列形式を、format パラメーターで指定されている形式で表現した値。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) メソッドは、現在のカルチャの規則を表す NumberFormatInfo オブジェクトを使用して、指定した書式で BigInteger 値を書式設定します。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
ラウンドトリップ ("R") 形式Round-trip ("R") format 既定の (現在の) カルチャDefault (current) culture ToString()
ラウンドトリップ ("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. formatString.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 がその他の値の場合、メソッドは 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)

指定された書式とカルチャ固有の書式情報を使用して、現在の 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

標準またはカスタムの数値書式指定文字列。A standard or custom numeric format string.

provider
IFormatProvider

カルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information.

戻り値

String

format パラメーターと providerパラメーターで指定されている現在の 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) メソッドは、指定されたカルチャの NumberFormatInfo オブジェクトを使用して、指定された書式で BigInteger 値を書式設定します。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
ラウンドトリップ ("R") 形式Round-trip ("R") format 既定の (現在の) カルチャDefault (current) culture ToString()
ラウンドトリップ ("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. formatString.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 がその他の値の場合、メソッドは 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 メソッドを呼び出し、NumberFormatInfo 型を表す Type オブジェクトに渡します。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 メソッドは、負の符号記号、桁区切り記号、小数点の記号など、value パラメーターの書式設定に関する情報を提供する NumberFormatInfo オブジェクトを返します。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) メソッドに書式情報を提供するには、次の3つの方法があります。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.

providernull場合、返される文字列の書式設定は、現在のカルチャの NumberFormatInfo オブジェクトに基づいています。If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

こちらもご覧ください

適用対象