BigInteger.ToString Methode

Definition

Namespace:: System.Numerics

Assemblys:: System.Numerics.dll, System.Runtime.Numerics.dll

Assemblys:: netstandard.dll, System.Runtime.Numerics.dll

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

Name	Beschreibung
ToString()	Konvertiert den numerischen Wert des aktuellen BigInteger Objekts in die entsprechende Zeichenfolgendarstellung.
ToString(IFormatProvider)	Konvertiert den numerischen Wert des aktuellen BigInteger Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen kulturspezifischen Formatierungsinformationen.
ToString(String)	Konvertiert den numerischen Wert des aktuellen BigInteger Objekts in die entsprechende Zeichenfolgendarstellung mithilfe des angegebenen Formats.
ToString(String, IFormatProvider)	Konvertiert den numerischen Wert des aktuellen BigInteger Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen Format- und kulturspezifischen Formatinformationen.

ToString()

Quelle:: BigInteger.cs

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 mithilfe 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 Format "R" oder "Roundtrip" 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
Roundtripformat ("R")	Eine bestimmte Kultur	ToString
Ein bestimmtes Format	Standardkultur (aktuell)	ToString(String)
Ein bestimmtes Format	Eine bestimmte Kultur	ToString(String, IFormatProvider)

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

Weitere Informationen

Gilt für:

ToString(IFormatProvider)

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

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

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 Format "R" oder "Roundtrip" mithilfe NumberFormatInfo des Objekts einer angegebenen Kultur. 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
Roundtripformat ("R")	Standardkultur (aktuell)	ToString()
Ein bestimmtes Format	Standardkultur (aktuell)	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 zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt. Wenn provider ja, wird nullder BigInteger Wert mithilfe NumberFormatInfo des Objekts der aktuellen Kultur formatiert. Die einzige Eigenschaft des NumberFormatInfo Objekts, das die Zeichenfolgendarstellung des Werts mithilfe des BigInteger allgemeinen Formatbezeichners steuert, ist NumberFormatInfo.NegativeSign, was das Zeichen definiert, das das negative Zeichen darstellt.

Der provider Parameter kann eine der folgenden Sein:

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

Gilt für:

ToString(String)

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Konvertiert den numerischen Wert des aktuellen BigInteger Objekts in die entsprechende Zeichenfolgendarstellung mithilfe des angegebenen Formats.

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 standard- oder benutzerdefinierte zahlenformatige Zeichenfolge.

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
Roundtripformat ("R")	Standardkultur (aktuell)	ToString()
Roundtripformat ("R")	Eine bestimmte Kultur	ToString(IFormatProvider)
Ein bestimmtes Format	Eine bestimmte Kultur	ToString(String, IFormatProvider)

Der format Parameter kann eine beliebige gültige numerische Standardzeichenfolge oder eine beliebige Kombination von benutzerdefinierten zahlenformatischen Zeichenfolgen sein. Wenn format gleich String.Empty oder gleich ist null, wird der Rückgabewert des aktuellen BigInteger Objekts mit dem Roundtrip-Formatbezeichner ("R") formatiert. Wenn format es sich um einen anderen Wert handelt, löst die Methode ein FormatException.

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

Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".
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. format Je nach Parameter steuert dieses Objekt Symbole wie das negative Zeichen, das Gruppentrennzeichen und das Dezimalkommasymbol 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(String, IFormatProvider)

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Quelle:: BigInteger.cs

Konvertiert den numerischen Wert des aktuellen BigInteger Objekts in die entsprechende Zeichenfolgendarstellung mithilfe der angegebenen Format- und kulturspezifischen Formatinformationen.

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 standard- oder benutzerdefinierte zahlenformatige Zeichenfolge.

provider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen BigInteger Werts, wie durch die format Parameter provider angegeben.

Implementiert

ToString(String, IFormatProvider)

Ausnahmen

FormatException

format ist keine gültige Formatzeichenfolge.

Beispiele

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

// 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 mithilfe NumberFormatInfo des Objekts einer angegebenen Kultur. 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
Roundtripformat ("R")	Standardkultur (aktuell)	ToString()
Roundtripformat ("R")	Eine bestimmte Kultur	ToString(IFormatProvider)
Ein bestimmtes Format	Standardkultur (aktuell)	ToString(String)

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

Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".
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 zum 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 es ein Type Objekt, das den NumberFormatInfo Typ darstellt. Die GetFormat Methode gibt dann das NumberFormatInfo Objekt zurück, das Informationen zum Formatieren des value Parameters bereitstellt, z. B. das Negative Zeichensymbol, das Gruppentrennzeichen oder das Dezimalkommasymbol. 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. (Seine Umsetzung GetFormat von nur zurückgibt.)
Sie können ein benutzerdefiniertes IFormatProviderObjekt übergeben, das implementiert wird. Die GetFormat Methode instanziiert und gibt das Objekt zurück, das NumberFormatInfo Formatierungsinformationen bereitstellt.

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Teilen über

BigInteger.ToString Methode

Definition

Überlädt

ToString()

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ToString(IFormatProvider)

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für:

ToString(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ToString(String, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback