BigInteger.ToString Metoda

Definice

Obor názvů:

System.Numerics

Sestavení:

System.Runtime.Numerics.dll

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci.

Přetížení

ToString(String, IFormatProvider)	Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi.
ToString(String)	Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci pomocí zadaného formátu.
ToString(IFormatProvider)	Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci pomocí informací formátování specifické pro zadanou jazykovou verzi.
ToString()	Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci.

ToString(String, IFormatProvider)

Zdroj:

BigInteger.cs

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi.

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

Parametry

format

String

Standardní nebo vlastní řetězec číselného formátu.

provider

IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcové vyjádření aktuální BigInteger hodnoty určené format parametry a provider

Implementuje

ToString(String, IFormatProvider)

Výjimky

FormatException

format není platný formátovací řetězec.

Příklady

Následující příklad inicializuje BigInteger hodnotu a zobrazí ji v konzole pomocí řetězce standardního formátu a objektu NumberFormatInfo , který definuje vlnovku (~) jako záporné znaménko.

// 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.
    let bigIntegerFormatter = NumberFormatInfo()
    bigIntegerFormatter.NegativeSign <- "~"

    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{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)

Poznámky

Metoda ToString(String, IFormatProvider) formátuje BigInteger hodnotu v zadaném formátu pomocí objektu NumberFormatInfo zadané jazykové verze. Pokud chcete použít formát doby odezvy nebo výchozí nastavení jazykové verze ToString , použijte další přetížení metody následujícím způsobem:

Použití formátu	Pro jazykovou verzi	Použití přetížení
Formát doby odezvy ("R")	Výchozí (aktuální) jazyková verze	ToString()
Formát doby odezvy ("R")	Konkrétní jazyková verze	ToString(IFormatProvider)
Konkrétní formát	Výchozí (aktuální) jazyková verze	ToString(String)

Parametrem format může být jakýkoli platný standardní číselný řetězec nebo libovolná kombinace řetězců vlastního číselného formátu. Pokud format je hodnota String.Empty rovna nebo je null, návratová hodnota aktuálního BigInteger objektu se naformátuje pomocí specifikátoru formátu odezvy ("R"). Pokud format je jakákoli jiná hodnota, metoda vyvolá FormatException.

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:

• Další informace o specifikátorech číselného formátu najdete v tématech Řetězce standardního číselného formátu a Vlastní řetězce číselného formátu.

• Další informace o podpoře formátování v .NET najdete v tématu Typy formátování.

Parametr provider je IFormatProvider implementace. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické pro jazykovou verzi o formátu řetězce vráceného touto metodou. Při vyvolání ToString(String, IFormatProvider) metody volá metodu parametru GetFormatprovider a předá jí Type objekt, který představuje NumberFormatInfo typ. Metoda GetFormat pak vrátí NumberFormatInfo objekt, který poskytuje informace pro formátování parametru value , například symbol záporného znaménka, symbol oddělovače skupin nebo symbol desetinné čárky. Existují tři způsoby použití parametru provider k poskytnutí informací o ToString(String, IFormatProvider) formátování metodě:

• Můžete předat CultureInfo objekt, který představuje jazykovou verzi, která poskytuje informace o formátování. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace o číselném formátování pro danou jazykovou verzi.

• Můžete předat skutečný NumberFormatInfo objekt, který poskytuje informace o číselném formátování. (Jeho implementace pouze GetFormat vrací sama sebe.)

• Můžete předat vlastní objekt, který implementuje IFormatProvider. Jeho GetFormat metoda vytvoří instanci a vrátí NumberFormatInfo objekt, který poskytuje informace o formátování.

Pokud provider je null, formátování vráceného řetězce je založeno na objektu NumberFormatInfo aktuální jazykové verze.

Viz také

• Standardní řetězce pro formátování čísel
• Vlastní řetězce číselného formátu

ToString(String)

Zdroj:

BigInteger.cs

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci pomocí zadaného formátu.

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

Parametry

format

String

Standardní nebo vlastní řetězec číselného formátu.

Návraty

String

Řetězcové vyjádření aktuální BigInteger hodnoty ve formátu určeném parametrem format .

Výjimky

FormatException

format není platný formátovací řetězec.

Příklady

Následující příklad inicializuje BigInteger hodnotu a zobrazí ji pomocí každého standardního řetězce formátu a některých řetězců vlastního formátu.

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)

    // Define a BigInteger value.
    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{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)

Poznámky

Metoda ToString(String) formátuje BigInteger hodnotu v zadaném formátu pomocí objektu NumberFormatInfo , který představuje konvence aktuální jazykové verze. Pokud chcete použít "R" nebo round-trip, formát nebo zadat jinou jazykovou verzi, použijte ostatní přetížení ToString metody následujícím způsobem:

Použití formátu	Pro jazykovou verzi	Použití přetížení
Formát doby odezvy ("R")	Výchozí (aktuální) jazyková verze	ToString()
Formát doby odezvy ("R")	Konkrétní jazyková verze	ToString(IFormatProvider)
Konkrétní formát	Konkrétní jazyková verze	ToString(String, IFormatProvider)

Parametrem format může být jakýkoli platný standardní číselný řetězec nebo libovolná kombinace řetězců vlastního číselného formátu. Pokud format je hodnota String.Empty rovna nebo je null, návratová hodnota aktuálního BigInteger objektu se naformátuje pomocí specifikátoru formátu odezvy ("R"). Pokud format je jakákoli jiná hodnota, metoda vyvolá FormatException.

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:

• Další informace o specifikátorech číselného formátu najdete v tématech Řetězce standardního číselného formátu a Vlastní řetězce číselného formátu.

• Další informace o podpoře formátování v .NET najdete v tématu Typy formátování.

Formát vráceného řetězce je určen objektem NumberFormatInfo pro aktuální jazykovou verzi. V závislosti na parametru format tento objekt řídí symboly, jako je záporné znaménko, oddělovač skupin a symbol desetinné čárky ve výstupním řetězci. Chcete-li poskytnout informace o formátování pro jiné jazykové verze než aktuální jazykovou verzi, zavolejte ToString(String, IFormatProvider) přetížení.

Viz také

• Standardní řetězce pro formátování čísel
• Vlastní řetězce číselného formátu

ToString(IFormatProvider)

Zdroj:

BigInteger.cs

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci pomocí informací formátování specifické pro zadanou jazykovou verzi.

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parametry

provider

IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcové vyjádření aktuální BigInteger hodnoty ve formátu určeném parametrem provider .

Příklady

Následující příklad vytvoří instanci vlastního NumberFormatInfo objektu, který definuje vlnovku (~) jako záporné znaménko. Metoda ToString(IFormatProvider) pak použije vlastní NumberFormatInfo objekt k zobrazení záporné BigInteger hodnoty.

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

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

Console.WriteLine(number.ToString(bigIntegerProvider));

let number = bigint 9867857831128L
let number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

let bigIntegerProvider = NumberFormatInfo()
bigIntegerProvider.NegativeSign <- "~"

printfn $"{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))

Poznámky

Metoda ToString(IFormatProvider) formátuje BigInteger hodnotu ve formátu R (round-trip) pomocí objektu NumberFormatInfo zadané jazykové verze. Pokud chcete zadat jiný formát nebo aktuální jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:

Použití formátu	Pro jazykovou verzi	Použití přetížení
Formát doby odezvy ("R")	Výchozí (aktuální) jazyková verze	ToString()
Konkrétní formát	Výchozí (aktuální) jazyková verze	ToString(String)
Konkrétní formát	Konkrétní jazyková verze	ToString(String, IFormatProvider)

Parametr provider je IFormatProvider implementace. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické pro jazykovou verzi o formátu řetězce vráceného touto metodou. Pokud provider je nullhodnota , BigInteger hodnota se naformátuje pomocí objektu NumberFormatInfo aktuální jazykové verze. Jedinou vlastností objektu NumberFormatInfo , který řídí řetězcové vyjádření BigInteger hodnoty pomocí obecného specifikátoru formátu, je NumberFormatInfo.NegativeSign, který definuje znak, který představuje záporné znaménko.

Parametr provider může být jeden z následujících:

• Objekt CultureInfo , který představuje jazykovou verzi, která poskytuje informace o formátování.

• Objekt NumberFormatInfo , který poskytuje informace o formátování.

• Vlastní objekt, který implementuje IFormatProvider. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace o formátování.

ToString()

Zdroj:

BigInteger.cs

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcovou reprezentaci.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Návraty

String

Řetězcové vyjádření aktuální BigInteger hodnoty.

Příklady

Následující příklad zobrazí BigInteger hodnotu pomocí výchozí ToString() metody. Zobrazuje také řetězcové reprezentace hodnoty, která je výsledkem použití některých standardních BigInteger specifikátorů formátu. Příklady jsou zobrazeny pomocí konvencí formátování jazykové verze 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.
    let value = BigInteger.Add(UInt64.MaxValue, 1024)

    // Display value using the default ToString method.
    printfn $"{value.ToString()}"
    // Display value using some standard format specifiers.
    printfn $"""{value.ToString("G")}"""
    printfn $"""{value.ToString("C")}"""
    printfn $"""{value.ToString("D")}"""
    printfn $"""{value.ToString("F")}"""
    printfn $"""{value.ToString("N")}"""
    printfn $"""{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

Poznámky

Metoda ToString() formátuje BigInteger hodnotu ve formátu R (round-trip) aktuální jazykové verze. Pokud chcete zadat jiný formát nebo jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:

Použití formátu	Pro jazykovou verzi	Použití přetížení
Formát doby odezvy ("R")	Konkrétní jazyková verze	ToString
Konkrétní formát	Výchozí (aktuální) jazyková verze	ToString(String)
Konkrétní formát	Konkrétní jazyková verze	ToString(String, IFormatProvider)

Řetězcové vyjádření BigInteger hodnoty obsahuje záporné znaménko, pokud je její hodnota záporná, a posloupnost číslic v rozsahu od 0 do 9 bez počátečních nul. Záporné znaménko je definováno objektem NumberFormatInfo pro aktuální jazykovou verzi.

Viz také

• Standardní řetězce pro formátování čísel
• Vlastní řetězce číselného formátu