BigInteger.ToString メソッド

リファレンス

定義

名前空間:: System.Numerics

アセンブリ:: System.Runtime.Numerics.dll

アセンブリ:: System.Numerics.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在の BigInteger オブジェクトの数値を等価の文字列形式に変換します。

オーバーロード

ToString(String, IFormatProvider)	指定された書式とカルチャ固有の書式情報を使用して、現在の BigInteger オブジェクトの数値をそれと等価の文字列形式に変換します。
ToString(String)	指定された書式を使用して、現在の BigInteger オブジェクトの数値をそれと等価な文字列形式に変換します。
ToString(IFormatProvider)	指定されたカルチャ固有の書式情報を使用して、現在の BigInteger オブジェクトの数値をそれと等価の文字列形式に変換します。
ToString()	現在の BigInteger オブジェクトの数値を等価の文字列形式に変換します。

ToString(String, IFormatProvider)

ソース:: BigInteger.cs

ソース:: BigInteger.cs

ソース:: BigInteger.cs

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

カルチャ固有の書式情報を提供するオブジェクト。

戻り値

String

format パラメーターと providerパラメーターで指定されている現在の BigInteger 値の文字列表現。

実装

ToString(String, IFormatProvider)

例外

FormatException

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 またはの場合format、null現在BigIntegerのオブジェクトの戻り値はラウンドトリップ書式指定子 ("R") で書式設定されます。が他の値である場合 format 、メソッドはを FormatExceptionスローします。

.NET では、広範な書式設定のサポートが提供されています。詳細については、次の書式設定に関するトピックを参照してください。

数値書式指定子の詳細については、「標準の数値書式指定文字列」および「カスタム数値書式指定文字列」を参照してください。
.NET での書式設定のサポートの詳細については、「型の書式設定」を参照してください。

パラメーターは provider 実装です IFormatProvider 。そのメソッドは GetFormat 、 NumberFormatInfo このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供するオブジェクトを返します。メソッドがToString(String, IFormatProvider)呼び出されると、パラメーターの GetFormat メソッドをprovider呼び出し、型をType表すオブジェクトをNumberFormatInfo渡します。次に、メソッドは GetFormat 、負符号 NumberFormatInfo 記号、グループ区切り記号、小数点記号など、パラメーターの書式設定 value に関する情報を提供するオブジェクトを返します。パラメーターを使用 provider して、メソッドに書式設定情報を指定するには、次の ToString(String, IFormatProvider) 3 つの方法があります。

書式設定情報を CultureInfo 提供するカルチャを表すオブジェクトを渡すことができます。そのメソッドは GetFormat 、そのカルチャの NumberFormatInfo 数値書式情報を提供するオブジェクトを返します。
数値書式情報を提供する実際 NumberFormatInfo のオブジェクトを渡すことができます。 (の実装 GetFormat は、それ自体を返すだけです)。
を実装 IFormatProviderするカスタムオブジェクトを渡すことができます。そのメソッドは GetFormat 、書式設定情報を提供するオブジェクトを NumberFormatInfo インスタンス化して返します。

がの場合provider、返される文字列の書式設定は、現在のカルチャの NumberFormatInfo オブジェクトに基nullづきます。

こちらもご覧ください

適用対象

ToString(String)

ソース:: BigInteger.cs

ソース:: BigInteger.cs

ソース:: BigInteger.cs

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

標準またはカスタムの数値書式指定文字列。

戻り値

String

現在の BigInteger 値の文字列形式を、format パラメーターで指定されている形式で表現した値。

例外

FormatException

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)

注釈

メソッドは ToString(String) 、現在の BigInteger カルチャの規則を表すオブジェクトを NumberFormatInfo 使用して、指定した形式で値を書式設定します。 "R" またはラウンドトリップを使用する場合、別のカルチャを書式設定または指定する場合は、次のようにメソッドの他のオーバーロードを ToString 使用します。

書式を使用するには	カルチャの場合	オーバーロードを使用する
ラウンドトリップ ("R") 形式	既定の (現在の) カルチャ	ToString()
ラウンドトリップ ("R") 形式	特定のカルチャ	ToString(IFormatProvider)
特定の形式	特定のカルチャ	ToString(String, IFormatProvider)

.NET では、広範な書式設定のサポートが提供されています。詳細については、次の書式設定に関するトピックを参照してください。

数値書式指定子の詳細については、「標準の数値書式指定文字列」および「カスタム数値書式指定文字列」を参照してください。
.NET での書式設定のサポートの詳細については、「型の書式設定」を参照してください。

返される文字列の形式は、現在のカルチャの NumberFormatInfo オブジェクトによって決まります。パラメーターに format 応じて、このオブジェクトは、負符号、グループ区切り記号、出力文字列の小数点記号などの記号を制御します。現在のカルチャ以外のカルチャの書式設定情報を提供するには、オーバーロードを ToString(String, IFormatProvider) 呼び出します。

こちらもご覧ください

適用対象

ToString(IFormatProvider)

ソース:: BigInteger.cs

ソース:: BigInteger.cs

ソース:: BigInteger.cs

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

カルチャ固有の書式情報を提供するオブジェクト。

戻り値

String

現在の BigInteger 値の文字列形式を、provider パラメーターで指定されている形式で表現した値。

例

次の例では、チルダ (~) を負の符号として定義するカスタム 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))

注釈

メソッドは ToString(IFormatProvider) 、 BigInteger 指定したカルチャのオブジェクトを使用 NumberFormatInfo して、"R" (ラウンドトリップ) 形式の値を書式設定します。別の形式または現在のカルチャを指定する場合は、次のようにメソッドの他のオーバーロードを ToString 使用します。

書式を使用するには	カルチャの場合	オーバーロードを使用する
ラウンドトリップ ("R") 形式	既定の (現在の) カルチャ	ToString()
特定の形式	既定の (現在の) カルチャ	ToString(String)
特定の形式	特定のカルチャ	ToString(String, IFormatProvider)

パラメーターは provider 実装です IFormatProvider 。そのメソッドは GetFormat 、 NumberFormatInfo このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供するオブジェクトを返します。が nullの場合provider、BigInteger値は現在のカルチャのオブジェクトをNumberFormatInfo使用して書式設定されます。一般的な書式指定子を NumberFormatInfo 使用して値の文字列表現を BigInteger 制御するオブジェクトの唯一のプロパティはです NumberFormatInfo.NegativeSign。これは、負の符号を表す文字を定義します。

パラメーターには provider 、次のいずれかを指定できます。

CultureInfo書式設定情報を提供するカルチャを表すオブジェクト。
NumberFormatInfo書式設定情報を提供するオブジェクト。
を実装 IFormatProviderするカスタムオブジェクト。そのメソッドは GetFormat 、書式設定情報を NumberFormatInfo 提供するオブジェクトを返します。

適用対象

ToString()

ソース:: BigInteger.cs

ソース:: BigInteger.cs

ソース:: BigInteger.cs

現在の BigInteger オブジェクトの数値を等価の文字列形式に変換します。

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

戻り値

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 から 9 までの数字のシーケンスが含まれます。負の符号は、現在のカルチャの NumberFormatInfo オブジェクトによって定義されます。

こちらもご覧ください

適用対象

BigInteger.ToString メソッド

定義

オーバーロード

ToString(String, IFormatProvider)

パラメーター

戻り値

実装

例外

例

注釈

こちらもご覧ください

適用対象

ToString(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ToString(IFormatProvider)

パラメーター

戻り値

例

注釈

適用対象

ToString()

戻り値

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース