BigInteger.ToString Metoda

Definice

Obor názvů:: System.Numerics

Sestavení:: System.Numerics.dll, System.Runtime.Numerics.dll

Sestavení:: netstandard.dll, System.Runtime.Numerics.dll

Sestavení:: System.Runtime.Numerics.dll

Sestavení:: System.Numerics.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření.

Přetížení

Name	Description
ToString()	Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření.
ToString(IFormatProvider)	Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření pomocí zadaných informací o formátování specifické pro jazykovou verzi.
ToString(String)	Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření pomocí zadaného formátu.
ToString(String, IFormatProvider)	Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi.

ToString()

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření.

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á reprezentace aktuální BigInteger hodnoty.

Příklady

Následující příklad zobrazí BigInteger hodnotu pomocí výchozí ToString() metody. Zobrazí také řetězcové reprezentace hodnoty, která je výsledkem použití některých specifikátorů standardního BigInteger formátu. Příklady se zobrazují 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 nebo 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 zpáteční cesty (R)	Konkrétní jazyková verze	ToString
Určitý formát	Výchozí (aktuální) jazyková verze	ToString(String)
Určitý formát	Konkrétní jazyková verze	ToString(String, IFormatProvider)

Řetězcová reprezentace BigInteger hodnoty obsahuje záporné znaménko, pokud je jeho 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é

Platí pro

ToString(IFormatProvider)

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření pomocí zadaných informací o formátování specifické pro jazykovou verzi.

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

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 nebo round-trip pomocí NumberFormatInfo objektu 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 zpáteční cesty (R)	Výchozí (aktuální) jazyková verze	ToString()
Určitý formát	Výchozí (aktuální) jazyková verze	ToString(String)
Určitý 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 ano null, BigInteger hodnota je formátována pomocí NumberFormatInfo objektu aktuální jazykové verze. Jedinou vlastností objektu NumberFormatInfo , který řídí řetězcovou BigInteger reprezentaci hodnoty pomocí specifikátoru obecného 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í.

Platí pro

ToString(String)

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření pomocí zadaného formátu.

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

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 vlastních formátových řetězců.

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 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 zpáteční cesty (R)	Výchozí (aktuální) jazyková verze	ToString()
Formát zpáteční cesty (R)	Konkrétní jazyková verze	ToString(IFormatProvider)
Určitý formát	Konkrétní jazyková verze	ToString(String, IFormatProvider)

Parametr format může být libovolný platný standardní číselný řetězec nebo libovolná kombinace vlastních řetězců číselného formátu. Je-li format roven String.Empty nebo je null, návratová hodnota aktuálního BigInteger objektu je formátována specifikátorem 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 o formátování:

Další informace o specifikátorech číselného formátu naleznete v tématu Standardní řetězce číselného formátu a vlastní řetězce číselného formátu.
Další informace o podpoře formátování v .NET naleznete 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í jazyková verze, zavolejte ToString(String, IFormatProvider) přetížení.

Viz také

Platí pro

ToString(String, IFormatProvider)

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Zdroj:: BigInteger.cs

Převede číselnou hodnotu aktuálního BigInteger objektu na ekvivalentní řetězcové vyjádření 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);

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é parametry format a provider parametry.

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 konzole pomocí standardní formátovací řetězec a NumberFormatInfo objekt, 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í NumberFormatInfo objektu zadané jazykové verze. Pokud chcete použít formát odezvy nebo výchozí nastavení jazykové verze, 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 zpáteční cesty (R)	Výchozí (aktuální) jazyková verze	ToString()
Formát zpáteční cesty (R)	Konkrétní jazyková verze	ToString(IFormatProvider)
Určitý formát	Výchozí (aktuální) jazyková verze	ToString(String)

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

Další informace o specifikátorech číselného formátu naleznete v tématu Standardní řetězce číselného formátu a vlastní řetězce číselného formátu.
Další informace o podpoře formátování v .NET naleznete 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. ToString(String, IFormatProvider) Při vyvolání metody volá metodu provider parametru GetFormat a předá jí Type objekt, který představuje NumberFormatInfo typ. Metoda GetFormat poté vrátí NumberFormatInfo objekt, který poskytuje informace pro formátování parametru value , jako je například symbol záporného znaménka, symbol oddělovače skupiny nebo symbol desetinné čárky. Existují tři způsoby použití parametru provider k poskytnutí informací o formátování metody ToString(String, IFormatProvider) :

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 číselné formátování informace pro danou jazykovou verzi.
Můžete předat skutečný NumberFormatInfo objekt, který poskytuje informace o číselném formátování. (Její implementace GetFormat pouze vrátí 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 NumberFormatInfo objektu aktuální jazykové verze.

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

BigInteger.ToString Metoda

Definice

Přetížení

ToString()

Návraty

Příklady

Poznámky

Viz také

Platí pro

ToString(IFormatProvider)

Parametry

Návraty

Příklady

Poznámky

Platí pro

ToString(String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

ToString(String, IFormatProvider)

Parametry

Návraty

Implementuje

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Váš názor