Int64.ToString Methode
Definition
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 Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.
Überlädt
ToString() |
Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. |
ToString(IFormatProvider) |
Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung. |
ToString(String) |
Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats. |
ToString(String, IFormatProvider) |
Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung. |
ToString()
- Quelle:
- Int64.cs
- Quelle:
- Int64.cs
- Quelle:
- Int64.cs
Konvertiert den Wert dieser Instanz 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
Die Zeichenfolgendarstellung des Werts dieser Instanz, die aus einem Minuszeichen, sofern die Zahl negativ ist, und einer Folge von Ziffern zwischen 0 bis 9 ohne führende Nullen besteht.
Beispiele
Im folgenden Beispiel wird ein Int64 Wert mit der Standardmethode ToString() angezeigt. Außerdem werden die Zeichenfolgendarstellungen des Werts angezeigt, der Int64 sich aus der Verwendung einer Reihe von Standardformatbezeichnern ergibt. Die Beispiele werden unter Verwendung der Formatierungskonventionen der en-US-Kultur angezeigt.
long value = -16325091;
// Display value using default ToString method.
Console.WriteLine(value.ToString()); // Displays -16325091
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")); // Displays -16325091
Console.WriteLine(value.ToString("C")); // Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D")); // Displays -16325091
Console.WriteLine(value.ToString("F")); // Displays -16325091.00
Console.WriteLine(value.ToString("N")); // Displays -16,325,091.00
Console.WriteLine(value.ToString("N0")); // Displays -16,325,091
Console.WriteLine(value.ToString("X")); // Displays FFFFFFFFFF06E61D
let value = -16325091L
// Display value using default ToString method.
printfn $"{value.ToString()}" // Displays -16325091
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}""" // Displays -16325091
printfn $"""{value.ToString "C"}""" // Displays ($16,325,091.00)
printfn $"""{value.ToString "D"}""" // Displays -16325091
printfn $"""{value.ToString "F"}""" // Displays -16325091.00
printfn $"""{value.ToString "N"}""" // Displays -16,325,091.00
printfn $"""{value.ToString "N0"}""" // Displays -16,325,091
printfn $"""{value.ToString "X"}""" // Displays FFFFFFFFFF06E61D
Dim value As Long = -16325091
' Display value using default ToString method.
Console.WriteLine(value.ToString()) ' Displays -16325091
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")) ' Displays -16325091
Console.WriteLine(value.ToString("C")) ' Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D")) ' Displays -16325091
Console.WriteLine(value.ToString("F")) ' Displays -16325091.00
Console.WriteLine(value.ToString("N")) ' Displays -16,325091.00
Console.WriteLine(value.ToString("X")) ' Displays FFFFFFFFFF06E61D
Hinweise
Die ToString() -Methode formatiert einen Int64 Wert im Standardformat ("G" oder allgemein) mithilfe des NumberFormatInfo -Objekts 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 |
---|---|---|
Standardformat ("G") | Eine bestimmte Kultur | ToString(IFormatProvider) |
Ein bestimmtes Format | Standardkultur (aktuell) | ToString(String) |
Ein bestimmtes Format | Eine bestimmte Kultur | ToString(String, IFormatProvider) |
.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Standardmäßige numerische Formatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.
Weitere Informationen
Gilt für:
ToString(IFormatProvider)
- Quelle:
- Int64.cs
- Quelle:
- Int64.cs
- Quelle:
- Int64.cs
Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
public:
virtual System::String ^ ToString(IFormatProvider ^ provider);
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 IFormatProvider, der kulturabhängige Formatierungsinformationen liefert.
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von provider
.
Implementiert
Beispiele
Im folgenden Beispiel wird die Zeichenfolgendarstellung eines Int64 Werts mithilfe CultureInfo von Objekten angezeigt, die mehrere verschiedene Kulturen darstellen.
long value = -16325901;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
// -16325901
// -16325901
// -16325901
let value = -16325901L
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB" )}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE" )}"""
// This example displays the following output to the console:
// -16325901
// -16325901
// -16325901
Dim value As Long = -16325801
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
' -16325901
' -16325901
' -16325901
Hinweise
Die ToString(IFormatProvider) -Methode formatiert einen Int64 Wert im Standardformat ("G" oder allgemein) mithilfe des NumberFormatInfo -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 |
---|---|---|
Standardformat ("G") | Standardkultur (aktuell) | ToString() |
Ein bestimmtes Format | Standardkultur (aktuell) | ToString(String) |
Ein bestimmtes Format | Eine bestimmte Kultur | ToString(String, IFormatProvider) |
Der provider
-Parameter ist ein -Objekt, das die IFormatProvider -Schnittstelle implementiert. Die - GetFormat Methode gibt ein NumberFormatInfo -Objekt zurück, das kulturspezifische Informationen über das Format der Zeichenfolge bereitstellt, die von dieser Methode zurückgegeben wird. Das Objekt, das implementiert IFormatProvider , kann eines der folgenden Sein:
Ein CultureInfo -Objekt, das die Kultur darstellt, deren Formatierungsregeln verwendet werden sollen.
Ein NumberFormatInfo -Objekt, das bestimmte numerische Formatierungsinformationen für diesen Wert enthält.
Ein benutzerdefiniertes Objekt, das implementiert und dessen GetFormat Methode ein NumberFormatInfo -Objekt zurückgibt, das Formatierungsinformationen IFormatProvider bereitstellt.
Wenn provider
ist null
oder ein NumberFormatInfo Objekt nicht aus provider
abgerufen werden kann, wird der Rückgabewert mit dem NumberFormatInfo -Objekt für die aktuelle Kultur formatiert.
.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Standardmäßige numerische Formatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.
Weitere Informationen
Gilt für:
ToString(String)
- Quelle:
- Int64.cs
- Quelle:
- Int64.cs
- Quelle:
- Int64.cs
Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung 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 numerische Formatierungszeichenfolge.
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format
.
Ausnahmen
format
ist ungültig oder wird nicht unterstützt.
Beispiele
Im folgenden Beispiel wird ein Int64 Wert mit jedem der unterstützten numerischen Standardformatbezeichner zusammen mit zwei benutzerdefinierten numerischen Formatzeichenfolgen angezeigt. Beim Konvertieren der numerischen Werte in Zeichenfolgen verwendet das Beispiel die Formatierungskonventionen der en-US-Kultur.
long value = -16325;
string specifier;
// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000.0).ToString(specifier));
// Displays: P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: X: FFFFFFFFFFFFC03B
// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: 0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays: #,#.00#;(#,#.00#): 16,325.00
let value = -16325L
// Use standard numeric format specifier.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: G: -16325
let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: C: ($16,325.00)
let specifier = "D8"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: D8: -00016325
let specifier = "E4"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: E4: -1.6325E+004
let specifier = "e3"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: e3: -1.633e+004
let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: F: -16325.00
let specifier = "N"
printfn $"{specifier}: {value.ToString specifier }"
// Displays: N: -16,325.00
let specifier = "P"
printfn $"{specifier}: {(float value / 100000.0).ToString specifier}"
// Displays: P: -16.33 %
let specifier = "X"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays: X: FFFFFFFFFFFFC03B
// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays: 0,0.000: -16,325.000
let specifier = "#,#.00#(#,#.00#)"
printfn $"{specifier}: {(value * -1L).ToString specifier}"
// Displays: #,#.00#(#,#.00#): 16,325.00
Dim value As Long = -16325
Dim specifier As String
' Use standard numeric format specifier.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: G: -16325
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: C: ($16,325.00)
specifier = "D8"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: D8: -00016325
specifier = "E4"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: E4: -1.6325E+004
specifier = "e3"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: e3: -1.633e+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: F: -16325.00
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: N: -16,325.00
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier))
' Displays: P: -16.33 %
specifier = "X"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: X: FFFFFFFFFFFFC03B
' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays: 0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays: #,#.00#;(#,#.00#): 16,325.00
Hinweise
Die ToString(String) -Methode formatiert einen Int64 Wert in einem angegebenen Format mithilfe eines NumberFormatInfo -Objekts, das die Konventionen der aktuellen Kultur darstellt. Wenn Sie das Standardformat ("G" oder allgemein) 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 |
---|---|---|
Standardformat ("G") | Standardkultur (aktuell) | ToString() |
Standardformat ("G") | Eine bestimmte Kultur | ToString(IFormatProvider) |
Ein bestimmtes Format | Eine bestimmte Kultur | ToString(String, IFormatProvider) |
Der format
Parameter kann ein beliebiger gültiger numerischer Standardformatbezeichner mit Ausnahme von "R" sowie eine beliebige Kombination von benutzerdefinierten numerischen Formatbezeichnern sein. Wenn format
oder eine leere Zeichenfolge ("") istnull
, wird der Rückgabewert dieses instance mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert.
.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:
Weitere Informationen zu numerischen Formatbezeichnern, numerischen Standardformatzeichenfolgen und benutzerdefinierten numerischen Formatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.
Der Rückgabewert dieses instance wird mit der NumberFormatInfo für die aktuelle Kultur formatiert.
Weitere Informationen
- Parse(String)
- String
- Formatieren von Typen in .NET
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen
- How to: Auffüllen einer Zahl mit führenden Nullen
Gilt für:
ToString(String, IFormatProvider)
- Quelle:
- Int64.cs
- Quelle:
- Int64.cs
- Quelle:
- Int64.cs
Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen 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 numerische Formatierungszeichenfolge.
- provider
- IFormatProvider
Ein Objekt, das kulturabhängige Formatierungsinformationen über diese Instanz liefert.
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format
und provider
.
Implementiert
Ausnahmen
format
ist ungültig oder wird nicht unterstützt.
Beispiele
Im folgenden Beispiel werden ein positiver und ein negativer Wert mit jedem der unterstützten numerischen Standardformatbezeichner für drei verschiedene Kulturen angezeigt.
// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
CultureInfo.CreateSpecificCulture("fr-FR"),
CultureInfo.CreateSpecificCulture("es-ES") };
long positiveNumber = 1679;
long negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "N0", "P", "X8"};
foreach (string specifier in specifiers)
{
foreach (CultureInfo culture in cultures)
{
// Display values with "G" format specifier.
Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",
specifier, culture.Name,
positiveNumber.ToString(specifier, culture),
negativeNumber.ToString(specifier, culture));
}
Console.WriteLine();
}
// The example displays the following output to the console:
// G format using en-US culture: 1679 -3045
// G format using fr-FR culture: 1679 -3045
// G format using es-ES culture: 1679 -3045
//
// C format using en-US culture: $1,679.00 ($3,045.00)
// C format using fr-FR culture: 1 679,00 € -3 045,00 €
// C format using es-ES culture: 1.679,00 € -3.045,00 €
//
// D8 format using en-US culture: 00001679 -00003045
// D8 format using fr-FR culture: 00001679 -00003045
// D8 format using es-ES culture: 00001679 -00003045
//
// E2 format using en-US culture: 1.68E+003 -3.05E+003
// E2 format using fr-FR culture: 1,68E+003 -3,05E+003
// E2 format using es-ES culture: 1,68E+003 -3,05E+003
//
// F format using en-US culture: 1679.00 -3045.00
// F format using fr-FR culture: 1679,00 -3045,00
// F format using es-ES culture: 1679,00 -3045,00
//
// N format using en-US culture: 1,679.00 -3,045.00
// N format using fr-FR culture: 1 679,00 -3 045,00
// N format using es-ES culture: 1.679,00 -3.045,00
//
// N0 format using en-US culture: 1,679 -3,045
// N0 format using fr-FR culture: 1 679 -3 045
// N0 format using es-ES culture: 1.679 -3.045
//
// P format using en-US culture: 167,900.00% -304,500.00%
// P format using fr-FR culture: 167 900,00 % -304 500,00 %
// P format using es-ES culture: 167.900,00 % -304.500,00 %
//
// X8 format using en-US culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
// Define cultures whose formatting conventions are to be used.
let cultures =
[| CultureInfo.CreateSpecificCulture "en-US"
CultureInfo.CreateSpecificCulture "fr-FR"
CultureInfo.CreateSpecificCulture "es-ES" |]
let positiveNumber = 1679L
let negativeNumber = -3045L
let specifiers = [| "G"; "C"; "D8"; "E2"; "F"; "N"; "N0"; "P"; "X8" |]
for specifier in specifiers do
for culture in cultures do
// Display values with "G" format specifier.
printfn $"{specifier} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"
printfn ""
// The example displays the following output to the console:
// G format using en-US culture: 1679 -3045
// G format using fr-FR culture: 1679 -3045
// G format using es-ES culture: 1679 -3045
//
// C format using en-US culture: $1,679.00 ($3,045.00)
// C format using fr-FR culture: 1 679,00 € -3 045,00 €
// C format using es-ES culture: 1.679,00 € -3.045,00 €
//
// D8 format using en-US culture: 00001679 -00003045
// D8 format using fr-FR culture: 00001679 -00003045
// D8 format using es-ES culture: 00001679 -00003045
//
// E2 format using en-US culture: 1.68E+003 -3.05E+003
// E2 format using fr-FR culture: 1,68E+003 -3,05E+003
// E2 format using es-ES culture: 1,68E+003 -3,05E+003
//
// F format using en-US culture: 1679.00 -3045.00
// F format using fr-FR culture: 1679,00 -3045,00
// F format using es-ES culture: 1679,00 -3045,00
//
// N format using en-US culture: 1,679.00 -3,045.00
// N format using fr-FR culture: 1 679,00 -3 045,00
// N format using es-ES culture: 1.679,00 -3.045,00
//
// N0 format using en-US culture: 1,679 -3,045
// N0 format using fr-FR culture: 1 679 -3 045
// N0 format using es-ES culture: 1.679 -3.045
//
// P format using en-US culture: 167,900.00% -304,500.00%
// P format using fr-FR culture: 167 900,00 % -304 500,00 %
// P format using es-ES culture: 167.900,00 % -304.500,00 %
//
// X8 format using en-US culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
// X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
' Define cultures whose formatting conventions are to be used.
Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
CultureInfo.CreateSpecificCulture("fr-FR"), _
CultureInfo.CreateSpecificCulture("es-ES") }
Dim positiveNumber As Long = 1679
Dim negativeNumber As Long = -3045
Dim specifiers() As String = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}
For Each specifier As String In specifiers
For Each culture As CultureInfo In Cultures
' Display values with "G" format specifier.
Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}", _
specifier, culture.Name, _
positiveNumber.ToString(specifier, culture), _
negativeNumber.ToString(specifier, culture))
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
'
' G format using en-US culture: 1679 -3045
' G format using fr-FR culture: 1679 -3045
' G format using es-ES culture: 1679 -3045
'
' C format using en-US culture: $1,679.00 ($3,045.00)
' C format using fr-FR culture: 1 679,00 € -3 045,00 €
' C format using es-ES culture: 1.679,00 € -3.045,00 €
'
' D8 format using en-US culture: 00001679 -00003045
' D8 format using fr-FR culture: 00001679 -00003045
' D8 format using es-ES culture: 00001679 -00003045
'
' E2 format using en-US culture: 1.68E+003 -3.05E+003
' E2 format using fr-FR culture: 1,68E+003 -3,05E+003
' E2 format using es-ES culture: 1,68E+003 -3,05E+003
'
' F format using en-US culture: 1679.00 -3045.00
' F format using fr-FR culture: 1679,00 -3045,00
' F format using es-ES culture: 1679,00 -3045,00
'
' N format using en-US culture: 1,679.00 -3,045.00
' N format using fr-FR culture: 1 679,00 -3 045,00
' N format using es-ES culture: 1.679,00 -3.045,00
'
' P format using en-US culture: 167,900.00% -304,500.00%
' P format using fr-FR culture: 167 900,00 % -304 500,00 %
' P format using es-ES culture: 167.900,00 % -304.500,00 %
'
' X8 format using en-US culture: 0000068F FFFFFFFFFFFFF41B
' X8 format using fr-FR culture: 0000068F FFFFFFFFFFFFF41B
' X8 format using es-ES culture: 0000068F FFFFFFFFFFFFF41B
Hinweise
Die ToString(String, IFormatProvider) -Methode formatiert einen Int64 Wert in einem angegebenen Format, indem das NumberFormatInfo -Objekt einer angegebenen Kultur verwendet wird. Wenn Sie die Standardformat- oder Kultureinstellungen verwenden möchten, verwenden Sie die anderen Überladungen der ToString -Methode wie folgt:
So verwenden Sie das Format | Für Kultur | Verwenden der Überladung |
---|---|---|
Standardformat ("G") | Standardkultur (aktuell) | ToString() |
Standardformat ("G") | Eine bestimmte Kultur | ToString(IFormatProvider) |
Ein bestimmtes Format | Standardkultur (aktuell) | ToString(String) |
Der format
Parameter kann entweder eine Standard- oder eine benutzerdefinierte numerische Formatzeichenfolge sein. Alle standardmäßigen numerischen Formatzeichenfolgen außer "R" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten numerischen Formatzeichen. Wenn format
eine leere Zeichenfolge ("") istnull
, wird der Rückgabewert für diese instance mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert.
Der provider
Parameter ist ein Objekt, das die IFormatProvider Schnittstelle implementiert. Die GetFormat -Methode gibt ein NumberFormatInfo -Objekt zurück, das kulturspezifische Informationen über das Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt. Das Objekt, das implementiert IFormatProvider wird, kann eines der folgenden Sein:
Ein CultureInfo -Objekt, das die Kultur darstellt, deren Formatierungsregeln verwendet werden sollen.
Ein NumberFormatInfo Objekt, das bestimmte numerische Formatierungsinformationen für diesen Wert enthält.
Ein benutzerdefiniertes Objekt, das implementiert und dessen GetFormat Methode ein NumberFormatInfo Objekt zurückgibt, das Formatierungsinformationen IFormatProvider bereitstellt.
Wenn provider
ein NumberFormatInfo -Objekt nicht null
von provider
abgerufen werden kann, wird der Rückgabewert für diese instance mit dem für die NumberFormatInfo aktuelle Kultur formatiert.
.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 Formatierung finden Sie unter Formatierungstypen.
Weitere Informationen
- Parse(String)
- Formatieren von Typen in .NET
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen
- How to: Auffüllen einer Zahl mit führenden Nullen
- Beispiel: .NET Core-Hilfsprogramm zur Formatierung von WinForms (C#)
- Beispiel: .NET Core-Hilfsprogramm zur Formatierung von WinForms (Visual Basic)
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für