BigInteger.ToString Methode

Definition

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current BigInteger object to its equivalent string representation.

Ü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.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format and culture-specific format information.

ToString(String)

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format.

ToString()

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current BigInteger object to its equivalent string representation.

ToString(IFormatProvider)

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting information.

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.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format and culture-specific format information.

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.A standard or custom numeric format string.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen BigInteger-Werts entsprechend den Angaben in den Parametern format und provider.The string representation of the current BigInteger value as specified by the format and provider parameters.

Implementiert

Ausnahmen

format ist keine gültige Formatzeichenfolge.format is not a valid format string.

Beispiele

Im folgenden Beispiel BigInteger wird ein-Wert initialisiert und mithilfe einer Standardformat Zeichenfolge und einem- NumberFormatInfo Objekt, das die Tilde (~) als negatives Vorzeichen definiert, der Konsole angezeigt.The following example initializes a BigInteger value, and displays it to the console using a standard format string and a NumberFormatInfo object that defines the tilde (~) as a negative sign.

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

Hinweise

Die- ToString(String, IFormatProvider) Methode formatiert einen BigInteger Wert in einem angegebenen Format unter Verwendung des- NumberFormatInfo Objekts einer angegebenen Kultur.The ToString(String, IFormatProvider) method formats a BigInteger value in a specified format by using the NumberFormatInfo object of a specified culture. Wenn Sie das Roundtrip-Format oder die Standard Kultur Einstellungen verwenden möchten, verwenden Sie die anderen über Ladungen der- ToString Methode wie folgt:If you want to use the round-trip format or default culture settings, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Roundtrip-Format ("R")Round-trip ("R") format Standard Kultur (aktuell)Default (current) culture ToString()
Roundtrip-Format ("R")Round-trip ("R") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)

Der- format Parameter kann eine beliebige gültige numerische Standard Zeichenfolgeoder eine beliebige Kombination von benutzerdefinierten numerischen FormatZeichenfolgen sein.The format parameter can be any valid standard numeric string, or any combination of custom numeric format strings. Wenn format gleich String.Empty oder ist null , wird der Rückgabewert des aktuellen- BigInteger Objekts mit dem Roundtrip-Format Bezeichner ("R") formatiert.If format is equal to String.Empty or is null, the return value of the current BigInteger object is formatted with the round-trip format specifier ("R"). Wenn format ein beliebiger anderer Wert ist, löst die Methode eine aus FormatException .If format is any other value, the method throws a FormatException.

.Net bietet umfangreiche Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der- provider Parameter ist eine- IFormatProvider Implementierung.The provider parameter is an IFormatProvider implementation. Die zugehörige- GetFormat Methode gibt ein- NumberFormatInfo Objekt zurück, das kulturspezifische Informationen zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Wenn die ToString(String, IFormatProvider) -Methode aufgerufen wird, ruft Sie die provider -Methode des-Parameters auf GetFormat und übergibt ihr ein- Type Objekt, das den- NumberFormatInfo Typ darstellt.When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's GetFormat method and passes it a Type object that represents the NumberFormatInfo type. Die- GetFormat Methode gibt dann das-Objekt zurück, NumberFormatInfo das Informationen zum Formatieren des- value Parameters bereitstellt, z. b. das negative Vorzeichen Symbol, das Gruppen Trennzeichen Symbol oder das Dezimaltrennzeichen.The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the value parameter, such as the negative sign symbol, the group separator symbol, or the decimal point symbol. Es gibt drei Möglichkeiten, den-Parameter zu verwenden, provider um Formatierungsinformationen für die-Methode bereitzustellen ToString(String, IFormatProvider) :There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Sie können ein- CultureInfo Objekt übergeben, das die Kultur darstellt, die Formatierungsinformationen bereitstellt.You can pass a CultureInfo object that represents the culture that supplies formatting information. GetFormatDie-Methode gibt das- NumberFormatInfo Objekt zurück, das numerische Formatierungsinformationen für diese Kultur bereitstellt.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Sie können das tatsächliche- NumberFormatInfo Objekt übergeben, das numerische Formatierungsinformationen bereitstellt.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Die Implementierung von GetFormat gibt nur sich selbst zurück.)(Its implementation of GetFormat just returns itself.)

  • Sie können ein benutzerdefiniertes Objekt übergeben, das implementiert IFormatProvider .You can pass a custom object that implements IFormatProvider. GetFormatDie-Methode instanziiert und gibt das NumberFormatInfo Objekt zurück, das Formatierungsinformationen bereitstellt.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Wenn den Wert provider null hat, basiert die Formatierung der zurückgegebenen Zeichenfolge auf dem- NumberFormatInfo Objekt der aktuellen Kultur.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Gilt für:

ToString(String)

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format.

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.A standard or custom numeric format string.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen BigInteger-Werts im durch den format-Parameter angegebenen Format.The string representation of the current BigInteger value in the format specified by the format parameter.

Ausnahmen

format ist keine gültige Formatzeichenfolge.format is not a valid format string.

Beispiele

Im folgenden Beispiel wird ein-Wert initialisiert und mit den BigInteger einzelnen Standardformat Zeichenfolgen und einigen benutzerdefinierten Format Zeichenfolgen angezeigt.The following example initializes a BigInteger value and displays it by using each standard format string and some custom format strings.

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)

Hinweise

Die- ToString(String) Methode formatiert einen BigInteger Wert in einem angegebenen Format mithilfe eines- NumberFormatInfo Objekts, das die Konventionen der aktuellen Kultur darstellt.The ToString(String) method formats a BigInteger value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Wenn Sie "R" oder "Roundtrip" verwenden möchten, können Sie die anderen über Ladungen der- ToString Methode wie folgt verwenden:If you want to use the "R", or round-trip, format or specify a different culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Roundtrip-Format ("R")Round-trip ("R") format Standard Kultur (aktuell)Default (current) culture ToString()
Roundtrip-Format ("R")Round-trip ("R") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Der- format Parameter kann eine beliebige gültige numerische Standard Zeichenfolgeoder eine beliebige Kombination von benutzerdefinierten numerischen FormatZeichenfolgen sein.The format parameter can be any valid standard numeric string, or any combination of custom numeric format strings. Wenn format gleich String.Empty oder ist null , wird der Rückgabewert des aktuellen- BigInteger Objekts mit dem Roundtrip-Format Bezeichner ("R") formatiert.If format is equal to String.Empty or is null, the return value of the current BigInteger object is formatted with the round-trip format specifier ("R"). Wenn format ein beliebiger anderer Wert ist, löst die Methode eine aus FormatException .If format is any other value, the method throws a FormatException.

.Net bietet umfangreiche Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Das Format der zurückgegebenen Zeichenfolge wird durch das- NumberFormatInfo Objekt für die aktuelle Kultur bestimmt.The format of the returned string is determined by the NumberFormatInfo object for the current culture. Abhängig vom- format Parameter steuert dieses-Objekt Symbole wie das negative Vorzeichen, das Gruppen Trennzeichen und das Dezimaltrennzeichen in der Ausgabe Zeichenfolge.Depending on the format parameter, this object controls symbols such as the negative sign, the group separator, and the decimal point symbol in the output string. Um Formatierungsinformationen für andere Kulturen als die aktuelle Kultur bereitzustellen, müssen Sie die-Überladung aufrufen ToString(String, IFormatProvider) .To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Gilt für:

ToString()

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current BigInteger object to its equivalent string representation.

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.The string representation of the current BigInteger value.

Beispiele

Im folgenden Beispiel wird ein- BigInteger Wert mit der-Standardmethode angezeigt ToString() .The following example displays a BigInteger value by using the default ToString() method. Außerdem werden die Zeichen folgen Darstellungen des BigInteger Werts angezeigt, der sich aus der Verwendung einiger Standardformat Bearbeiter ergibt.It also displays the string representations of the BigInteger value that results from using some standard format specifiers. Die Beispiele werden mithilfe der Formatierungs Konventionen der Kultur "en-US" angezeigt.The examples are displayed using the formatting conventions of the en-US culture.

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

Hinweise

Die- ToString() Methode formatiert einen BigInteger Wert im Format "R" oder im Roundtrip-Format der aktuellen Kultur.The ToString() method formats a BigInteger value in the "R", or round-trip, format of the current culture. Wenn Sie ein anderes Format oder eine andere Kultur angeben möchten, verwenden Sie die anderen über Ladungen der- ToString Methode wie folgt:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Roundtrip-Format ("R")Round-trip ("R") format Eine bestimmte KulturA specific culture ToString
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Die Zeichen folgen Darstellung des BigInteger Werts enthält ein negatives Vorzeichen, wenn der Wert negativ ist, und eine Folge von Ziffern zwischen 0 und 9 ohne führende Nullen.The string representation of the BigInteger value includes a negative sign if its value is negative, and a sequence of digits ranging from 0 to 9 without leading zeros. Das negative Vorzeichen wird durch das- NumberFormatInfo Objekt für die aktuelle Kultur definiert.The negative sign is defined by the NumberFormatInfo object for the current culture.

Gilt für:

ToString(IFormatProvider)

Konvertiert den numerischen Wert des aktuellen BigInteger-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting information.

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.An object that supplies culture-specific formatting information.

Gibt zurück

String

Die Zeichenfolgendarstellung des aktuellen BigInteger-Werts im durch den provider-Parameter angegebenen Format.The string representation of the current BigInteger value in the format specified by the provider parameter.

Beispiele

Im folgenden Beispiel wird ein benutzerdefiniertes-Objekt instanziiert NumberFormatInfo , das die Tilde (~) als negatives Vorzeichen definiert.The following example instantiates a custom NumberFormatInfo object that defines the tilde (~) as a negative sign. Die- ToString(IFormatProvider) Methode verwendet dann das benutzerdefinierte- NumberFormatInfo Objekt, um einen negativen BigInteger Wert anzuzeigen.The ToString(IFormatProvider) method then uses the custom NumberFormatInfo object to display a negative BigInteger value.

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

Hinweise

Die-Methode formatiert ToString(IFormatProvider) einen BigInteger Wert im "R"-oder Roundtrip-Format unter Verwendung des- NumberFormatInfo Objekts einer angegebenen Kultur.The ToString(IFormatProvider) method formats a BigInteger value in the "R", or round-trip, format by using the NumberFormatInfo object of a specified culture. Wenn Sie ein anderes Format oder die aktuelle Kultur angeben möchten, verwenden Sie die anderen über Ladungen der- ToString Methode wie folgt:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Roundtrip-Format ("R")Round-trip ("R") format Standard Kultur (aktuell)Default (current) culture ToString()
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Der- provider Parameter ist eine- IFormatProvider Implementierung.The provider parameter is an IFormatProvider implementation. Die zugehörige- GetFormat Methode gibt ein- NumberFormatInfo Objekt zurück, das kulturspezifische Informationen zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Wenn provider den null Wert hat, BigInteger wird der Wert mithilfe des- NumberFormatInfo Objekts der aktuellen Kultur formatiert.If provider is null, the BigInteger value is formatted using the NumberFormatInfo object of the current culture. Die einzige Eigenschaft des- NumberFormatInfo Objekts, das die Zeichen folgen Darstellung des BigInteger Werts mit dem allgemeinen Format Bezeichner steuert NumberFormatInfo.NegativeSign , ist, wodurch das Zeichen definiert wird, das das negative Vorzeichen darstellt.The only property of the NumberFormatInfo object that controls the string representation of the BigInteger value using the general format specifier is NumberFormatInfo.NegativeSign, which defines the character that represents the negative sign.

Der provider Parameter kann eines der folgenden sein:The provider parameter can be one of the following:

Gilt für: