Int64.ToString Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu.
Przeciążenia
| Nazwa | Opis |
|---|---|
| ToString() |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu. |
| ToString(IFormatProvider) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonych informacji o formacie specyficznym dla kultury. |
| ToString(String) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu. |
| ToString(String, IFormatProvider) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu i informacji o formacie specyficznym dla kultury. |
ToString()
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu.
public:
override System::String ^ ToString();
public override string ToString();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Zwraca
Ciąg reprezentujący wartość tego wystąpienia, składający się z znaku minus, jeśli wartość jest ujemna, a sekwencja cyfr z zakresu od 0 do 9 bez zer wiodących.
Przykłady
Poniższy przykład przedstawia Int64 wartość przy użyciu metody domyślnej ToString() . Wyświetla również reprezentacje ciągów Int64 wartości, z których wynika użycie wielu specyfikatorów formatu standardowego. Przykłady są wyświetlane przy użyciu konwencji formatowania kultury en-US.
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
Uwagi
Metoda ToString() formatuje Int64 wartość w domyślnym formacie ("G" lub ogólnym) przy użyciu NumberFormatInfo obiektu bieżącej kultury. Jeśli chcesz określić inny format lub kulturę, użyj innych przeciążeń ToString metody w następujący sposób:
| Aby użyć formatu | Dla kultury | Używanie przeciążenia |
|---|---|---|
| Domyślny format ("G") | Określona kultura | ToString(IFormatProvider) |
| Określony format | Domyślna (bieżąca) kultura | ToString(String) |
| Określony format | Określona kultura | ToString(String, IFormatProvider) |
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:
Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.
Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.
Zobacz też
Dotyczy
ToString(IFormatProvider)
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonych informacji o formacie specyficznym dla kultury.
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
Parametry
- provider
- IFormatProvider
Element IFormatProvider , który dostarcza informacje o formatowaniu specyficznym dla kultury.
Zwraca
Ciąg reprezentujący wartość tego wystąpienia zgodnie z parametrem provider.
Implementuje
Przykłady
W poniższym przykładzie przedstawiono reprezentację Int64 ciągu wartości przy użyciu CultureInfo obiektów reprezentujących kilka różnych kultur.
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
Uwagi
Metoda ToString(IFormatProvider) formatuje Int64 wartość w domyślnym formacie ("G" lub ogólnym) przy użyciu NumberFormatInfo obiektu określonej kultury. Jeśli chcesz określić inny format lub bieżącą kulturę, użyj innych przeciążeń ToString metody w następujący sposób:
| Aby użyć formatu | Dla kultury | Używanie przeciążenia |
|---|---|---|
| Domyślny format ("G") | Domyślna (bieżąca) kultura | ToString() |
| Określony format | Domyślna (bieżąca) kultura | ToString(String) |
| Określony format | Określona kultura | ToString(String, IFormatProvider) |
Parametr provider jest obiektem, który implementuje IFormatProvider interfejs. Metoda GetFormat zwraca NumberFormatInfo obiekt, który dostarcza informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę. Obiekt, który implementuje IFormatProvider , może być dowolny z następujących:
CultureInfo Obiekt reprezentujący kulturę, której mają być używane reguły formatowania.
NumberFormatInfo Obiekt zawierający określone informacje o formatowaniu liczbowym dla tej wartości.
Obiekt niestandardowy, który implementuje IFormatProvider metodę GetFormat i której NumberFormatInfo metoda zwraca obiekt, który udostępnia informacje o formatowaniu.
Jeśli provider obiekt jest null lub NumberFormatInfo nie można uzyskać obiektu z providerklasy , wartość zwracana jest sformatowana za pomocą NumberFormatInfo obiektu dla bieżącej kultury.
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:
Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.
Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.
Zobacz też
Dotyczy
ToString(String)
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu.
public:
System::String ^ ToString(System::String ^ format);
public string ToString(string format);
public string ToString(string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String
Parametry
- format
- String
Ciąg formatu liczbowego.
Zwraca
Ciąg reprezentujący wartość tego wystąpienia zgodnie z parametrem format.
Wyjątki
format jest nieprawidłowy lub nie jest obsługiwany.
Przykłady
Poniższy przykład przedstawia Int64 wartość przy użyciu każdego z obsługiwanych standardowych specyfikatorów formatu liczbowego wraz z dwoma niestandardowymi ciągami formatu liczbowego. W konwertowaniu wartości liczbowych na ciągi przykład używa konwencji formatowania kultury en-US.
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
Uwagi
Metoda ToString(String) formatuje Int64 wartość w określonym formacie przy użyciu NumberFormatInfo obiektu reprezentującego konwencje bieżącej kultury. Jeśli chcesz użyć domyślnego formatu ("G" lub ogólnego) lub określić inną kulturę, użyj innych przeciążeń ToString metody w następujący sposób:
| Aby użyć formatu | Dla kultury | Używanie przeciążenia |
|---|---|---|
| Domyślny format ("G") | Domyślna (bieżąca) kultura | ToString() |
| Domyślny format ("G") | Określona kultura | ToString(IFormatProvider) |
| Określony format | Określona kultura | ToString(String, IFormatProvider) |
Parametr format może być dowolnym prawidłowym standardowym specyfikatorem formatu liczbowego z wyjątkiem "R", a także dowolnej kombinacji niestandardowych specyfikatorów formatu liczbowego. Jeśli format jest null lub pusty ciąg (""), zwracana wartość tego wystąpienia jest formatowana za pomocą ogólnego specyfikatora formatu liczbowego ("G").
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:
Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, standardowych ciągów formatu liczbowego i niestandardowych ciągów formatu liczbowego.
Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.
Wartość zwracana tego wystąpienia jest formatowana z wartością NumberFormatInfo dla bieżącej kultury.
Zobacz też
- Parse(String)
- String
- Typy formatowania na platformie .NET
- Standardowe ciągi formatów liczbowych
- Niestandardowe ciągi formatujące liczby
- Instrukcje: uzupełnianie liczby z wiodącymi zerami
Dotyczy
ToString(String, IFormatProvider)
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
- Źródło:
- Int64.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu i informacji o formacie specyficznym dla kultury.
public:
virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString(string format, IFormatProvider provider);
public string ToString(string? format, IFormatProvider? provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String
Parametry
- format
- String
Ciąg formatu liczbowego.
- provider
- IFormatProvider
Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury dotyczące tego wystąpienia.
Zwraca
Ciąg reprezentujący wartość tego wystąpienia zgodnie z parametrami format i provider.
Implementuje
Wyjątki
format jest nieprawidłowy lub nie jest obsługiwany.
Przykłady
W poniższym przykładzie jest wyświetlana wartość dodatnia i ujemna przy użyciu każdego z obsługiwanych standardowych specyfikatorów formatu liczbowego dla trzech różnych kultur.
// 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
Uwagi
Metoda ToString(String, IFormatProvider) formatuje Int64 wartość w określonym formacie przy użyciu NumberFormatInfo obiektu określonej kultury. Jeśli chcesz użyć domyślnych ustawień formatu lub kultury, użyj innych przeciążeń ToString metody w następujący sposób:
| Aby użyć formatu | Dla kultury | Używanie przeciążenia |
|---|---|---|
| Domyślny format ("G") | Domyślna (bieżąca) kultura | ToString() |
| Domyślny format ("G") | Określona kultura | ToString(IFormatProvider) |
| Określony format | Domyślna (bieżąca) kultura | ToString(String) |
Parametr format może być standardowym lub niestandardowym ciągiem formatu liczbowego. Obsługiwane są wszystkie standardowe ciągi formatu liczbowego inne niż "R" (lub "r"), podobnie jak wszystkie niestandardowe znaki formatu liczbowego. Jeśli format jest null lub pusty ciąg (""), wartość zwracana dla tego wystąpienia jest sformatowana za pomocą ogólnego specyfikatora formatu liczbowego ("G").
Parametr provider jest obiektem, który implementuje IFormatProvider interfejs. Metoda GetFormat zwraca NumberFormatInfo obiekt, który dostarcza informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę. Obiekt, który implementuje IFormatProvider , może być dowolny z następujących:
CultureInfo Obiekt reprezentujący kulturę, której mają być używane reguły formatowania.
NumberFormatInfo Obiekt zawierający określone informacje o formatowaniu liczbowym dla tej wartości.
Obiekt niestandardowy, który implementuje IFormatProvider metodę GetFormat i której NumberFormatInfo metoda zwraca obiekt, który udostępnia informacje o formatowaniu.
Jeśli provider obiekt jest null lub NumberFormatInfo nie można uzyskać obiektu z providerklasy , wartość zwracana dla tego wystąpienia jest sformatowana za pomocą NumberFormatInfo wartości dla bieżącej kultury.
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:
Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.
Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.
Zobacz też
- Parse(String)
- Typy formatowania na platformie .NET
- Standardowe ciągi formatów liczbowych
- Niestandardowe ciągi formatujące liczby
- Instrukcje: uzupełnianie liczby z wiodącymi zerami
- Przykład: .NET Core WinForms Formatting Utility (C#)
- Przykład: .NET Core WinForms Formatting Utility (Visual Basic)