BigInteger.ToString Methode

Referenz

Definition

Namespace:: System.Numerics

Assembly:: System.Runtime.Numerics.dll

Assembly:: System.Numerics.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts in die entsprechende Zeichenfolgendarstellung.

Überlädt

ToString(String, IFormatProvider)	Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung des angegebenen Formats und der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(String)	Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.
ToString(IFormatProvider)	Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString()	Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts in die entsprechende Zeichenfolgendarstellung.

ToString(String, IFormatProvider)

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung des angegebenen Formats und der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

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

Parameter

format: String

Eine standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen BigInteger-Werts entsprechend den Angaben in den Parametern format und provider.

Implementiert

ToString(String, IFormatProvider)

Ausnahmen

FormatException

format ist keine gültige Formatzeichenfolge.

Beispiele

Im folgenden Beispiel wird ein BigInteger Wert initialisiert und der Konsole mithilfe einer Standardformatzeichenfolge und eines NumberFormatInfo Objekts angezeigt, das die Tilde (~) als negatives Zeichen definiert.

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

Hinweise

Die ToString(String, IFormatProvider) -Methode formatiert einen BigInteger Wert in einem angegebenen Format, indem das NumberFormatInfo Objekt einer angegebenen Kultur verwendet wird. Wenn Sie das Roundtripformat oder die Standardkultureinstellungen verwenden möchten, verwenden Sie die anderen Überladungen der ToString Methode wie folgt:

So verwenden Sie das Format	Für Kultur	Verwenden der Überladung
Hin- und Rückflugformat ("R")	Standardkultur (aktuelle Kultur)	ToString()
Hin- und Rückflugformat ("R")	Eine bestimmte Kultur	ToString(IFormatProvider)
Ein bestimmtes Format	Standardkultur (aktuelle Kultur)	ToString(String)

Der format Parameter kann eine beliebige gültige numerische Standardzeichenfolge oder eine beliebige Kombination von benutzerdefinierten numerischen Formatzeichenfolgen sein. Wenn format gleich String.Empty oder ist null, wird der Rückgabewert des aktuellen BigInteger Objekts mit dem Roundtripformatbezeichner ("R") formatiert. Wenn format ein anderer Wert ist, löst die -Methode einen aus FormatException.

.NET bietet umfangreiche Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Unterstützung der Formatierung in .NET finden Sie unter Formatierungstypen.

Der provider Parameter ist eine IFormatProvider Implementierung. Die - GetFormat Methode gibt ein NumberFormatInfo -Objekt zurück, das kulturspezifische Informationen über das Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt. Wenn die ToString(String, IFormatProvider) Methode aufgerufen wird, ruft sie die Methode des providerGetFormat Parameters auf und übergibt ihr ein Type Objekt, das den NumberFormatInfo Typ darstellt. Die GetFormat -Methode gibt dann das -Objekt zurück, das NumberFormatInfo Informationen zum Formatieren des value Parameters bereitstellt, z. B. das Negativzeichensymbol, das Gruppentrennzeichen oder das Dezimalzeichensymbol. Es gibt drei Möglichkeiten, den provider -Parameter zum Bereitstellen von Formatierungsinformationen für die ToString(String, IFormatProvider) -Methode zu verwenden:

Sie können ein CultureInfo -Objekt übergeben, das die Kultur darstellt, die Formatierungsinformationen bereitstellt. Die - GetFormat Methode gibt das NumberFormatInfo -Objekt zurück, das numerische Formatierungsinformationen für diese Kultur bereitstellt.
Sie können das tatsächliche NumberFormatInfo Objekt übergeben, das numerische Formatierungsinformationen bereitstellt. (Die Implementierung von GetFormat gibt sich selbst zurück.)
Sie können ein benutzerdefiniertes IFormatProviderObjekt übergeben, das implementiert. Ihre GetFormat Methode instanziiert und gibt das Objekt zurück, das NumberFormatInfo Formatierungsinformationen bereitstellt.

Wenn provider ist null, basiert die Formatierung der zurückgegebenen Zeichenfolge auf dem NumberFormatInfo Objekt der aktuellen Kultur.

Weitere Informationen

Gilt für:

ToString(String)

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.

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

Parameter

format: String

Eine standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen BigInteger-Werts im durch den format-Parameter angegebenen Format.

Ausnahmen

FormatException

format ist keine gültige Formatzeichenfolge.

Beispiele

Im folgenden Beispiel wird ein BigInteger Wert initialisiert und mit jeder Standardformatzeichenfolge und einigen benutzerdefinierten Formatzeichenfolgen angezeigt.

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)

Hinweise

Die ToString(String) -Methode formatiert einen BigInteger Wert in einem angegebenen Format mithilfe eines NumberFormatInfo -Objekts, das die Konventionen der aktuellen Kultur darstellt. Wenn Sie das R- oder Roundtripformat verwenden oder eine andere Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString -Methode wie folgt:

So verwenden Sie das Format	Für Kultur	Verwenden der Überladung
Hin- und Rückflugformat ("R")	Standardkultur (aktuelle Kultur)	ToString()
Hin- und Rückflugformat ("R")	Eine bestimmte Kultur	ToString(IFormatProvider)
Ein bestimmtes Format	Eine bestimmte Kultur	ToString(String, IFormatProvider)

.NET bietet umfangreiche Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Unterstützung der Formatierung in .NET finden Sie unter Formatierungstypen.

Das Format der zurückgegebenen Zeichenfolge wird durch das NumberFormatInfo -Objekt für die aktuelle Kultur bestimmt. Je format nach Parameter steuert dieses Objekt Symbole wie das negative Vorzeichen, das Gruppentrennzeichen und das Dezimalzeichen in der Ausgabezeichenfolge. Um Formatierungsinformationen für andere Kulturen als die aktuelle Kultur bereitzustellen, rufen Sie die ToString(String, IFormatProvider) Überladung auf.

Weitere Informationen

Gilt für:

ToString(IFormatProvider)

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

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

Parameter

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen BigInteger-Werts im durch den provider-Parameter angegebenen Format.

Beispiele

Im folgenden Beispiel wird ein benutzerdefiniertes NumberFormatInfo Objekt instanziiert, das die Tilde (~) als negatives Zeichen definiert. Die ToString(IFormatProvider) -Methode verwendet dann das benutzerdefinierte NumberFormatInfo Objekt, um einen negativen BigInteger Wert anzuzeigen.

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

Hinweise

Die ToString(IFormatProvider) -Methode formatiert einen BigInteger Wert im R- oder Roundtripformat, indem das NumberFormatInfo Objekt einer angegebenen Kultur verwendet wird. Wenn Sie ein anderes Format oder die aktuelle Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString -Methode wie folgt:

So verwenden Sie das Format	Für Kultur	Verwenden der Überladung
Hin- und Rückflugformat ("R")	Standardkultur (aktuelle Kultur)	ToString()
Ein bestimmtes Format	Standardkultur (aktuelle Kultur)	ToString(String)
Ein bestimmtes Format	Eine bestimmte Kultur	ToString(String, IFormatProvider)

Der provider Parameter ist eine IFormatProvider Implementierung. Die - GetFormat Methode gibt ein NumberFormatInfo -Objekt zurück, das kulturspezifische Informationen über das Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt. Wenn provider ist null, wird der BigInteger Wert mithilfe des NumberFormatInfo -Objekts der aktuellen Kultur formatiert. Die einzige Eigenschaft des NumberFormatInfo -Objekts, die die Zeichenfolgendarstellung des Werts mithilfe des BigInteger allgemeinen Formatbezeichners steuert, ist , wodurch das Zeichen definiert wird NumberFormatInfo.NegativeSign, das das negative Zeichen darstellt.

Der provider Parameter kann einer der folgenden Sein:

Ein CultureInfo -Objekt, das die Kultur darstellt, die Formatierungsinformationen bereitstellt.
Das NumberFormatInfo Objekt, das Formatierungsinformationen bereitstellt.
Ein benutzerdefiniertes IFormatProviderObjekt, das implementiert. Die - GetFormat Methode gibt das NumberFormatInfo -Objekt zurück, das Formatierungsinformationen bereitstellt.

Gilt für:

ToString()

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts in die entsprechende Zeichenfolgendarstellung.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen BigInteger-Werts.

Beispiele

Im folgenden Beispiel wird ein BigInteger Wert mit der Standardmethode ToString() angezeigt. Außerdem werden die Zeichenfolgendarstellungen des Werts angezeigt, der BigInteger sich aus der Verwendung einiger Standardformatbezeichner ergibt. Die Beispiele werden mithilfe der Formatierungskonventionen der en-US-Kultur angezeigt.

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

Hinweise

Die ToString() -Methode formatiert einen BigInteger Wert im R- oder Roundtripformat der aktuellen Kultur. Wenn Sie ein anderes Format oder eine andere Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString Methode wie folgt:

So verwenden Sie das Format	Für Kultur	Verwenden der Überladung
Hin- und Rückflugformat ("R")	Eine bestimmte Kultur	ToString
Ein bestimmtes Format	Standardkultur (aktuelle Kultur)	ToString(String)
Ein bestimmtes Format	Eine bestimmte Kultur	ToString(String, IFormatProvider)

Die Zeichenfolgendarstellung des BigInteger Werts enthält ein negatives Vorzeichen, wenn sein Wert negativ ist, und eine Sequenz von Ziffern zwischen 0 und 9 ohne führende Nullen. Das negative Vorzeichen wird durch das NumberFormatInfo -Objekt für die aktuelle Kultur definiert.

Weitere Informationen

Gilt für:

Freigeben über

BigInteger.ToString Methode

Definition

Überlädt

ToString(String, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ToString(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ToString(IFormatProvider)

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für:

ToString()

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen