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
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() |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu. |
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(IFormatProvider)
- Ź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
IFormatProvider, który dostarcza informacje o formatowaniu specyficznym dla kultury.
Zwraca
Ciąg reprezentujący wartość tego wystąpienia zgodnie z provider
.
Implementuje
Przykłady
W poniższym przykładzie przedstawiono reprezentację ciągu wartości Int64 przy użyciu obiektów CultureInfo 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 wartość Int64 w domyślnym formacie ("G" lub ogólnym) przy użyciu obiektu NumberFormatInfo określonej kultury. Jeśli chcesz określić inny format lub bieżącą kulturę, użyj innych przeciążeń metody ToString 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
to obiekt, który implementuje interfejs IFormatProvider. Metoda GetFormat zwraca obiekt NumberFormatInfo, który udostępnia informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę. Obiekt implementujący IFormatProvider może być dowolnym z następujących elementów:
Obiekt CultureInfo reprezentujący kulturę, której mają być używane reguły formatowania.
Obiekt NumberFormatInfo zawierający określone informacje o formatowaniu liczbowym dla tej wartości.
Obiekt niestandardowy, który implementuje IFormatProvider i którego metoda GetFormat zwraca obiekt NumberFormatInfo, który udostępnia informacje o formatowaniu.
Jeśli provider
jest null
lub nie można uzyskać obiektu NumberFormatInfo z provider
, wartość zwracana jest sformatowana za pomocą obiektu NumberFormatInfo 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)
- String
- typy formatowania na platformie .NET
Dotyczy
ToString()
- Ź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 wartość Int64 przy użyciu domyślnej metody ToString(). Wyświetla również reprezentacje ciągów Int64 wartości, która wynika z używania 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 wartość Int64 w domyślnym formacie ("G" lub ogólnym) przy użyciu obiektu NumberFormatInfo bieżącej kultury. Jeśli chcesz określić inny format lub kulturę, użyj innych przeciążeń metody ToString 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ż
- Parse(String)
- String
- typy formatowania na platformie .NET
Dotyczy
ToString(String)
- Ź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 format
.
Wyjątki
format
jest nieprawidłowa lub nie jest obsługiwana.
Przykłady
Poniższy przykład przedstawia wartość Int64 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 wartość Int64 w określonym formacie przy użyciu obiektu NumberFormatInfo 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ń metody ToString 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 przy użyciu 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, standardowe ciągi formatu liczbowego i niestandardowe ciągi formatu liczbowego.
Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.
Wartość zwracana tego wystąpienia jest formatowana przy użyciu NumberFormatInfo dla bieżącej kultury.
Zobacz też
- Parse(String)
- String
- typy formatowania na platformie .NET
- standardowych ciągów formatu liczbowego
- niestandardowe ciągi formatu liczbowego
- Instrukcje: dopełnienie liczby zerami wiodącymi
Dotyczy
ToString(String, IFormatProvider)
- Ź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 reprezentacja wartości tego wystąpienia określona przez format
i provider
.
Implementuje
Wyjątki
format
jest nieprawidłowa lub nie jest obsługiwana.
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 wartość Int64 w określonym formacie przy użyciu obiektu NumberFormatInfo określonej kultury. Jeśli chcesz użyć domyślnych ustawień formatu lub kultury, użyj innych przeciążeń metody ToString 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 formatowana przy użyciu ogólnego specyfikatora formatu liczbowego ("G").
Parametr provider
to obiekt, który implementuje interfejs IFormatProvider. Metoda GetFormat zwraca obiekt NumberFormatInfo, który udostępnia informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę. Obiekt implementujący IFormatProvider może być dowolnym z następujących elementów:
Obiekt CultureInfo reprezentujący kulturę, której mają być używane reguły formatowania.
Obiekt NumberFormatInfo zawierający określone informacje o formatowaniu liczbowym dla tej wartości.
Obiekt niestandardowy, który implementuje IFormatProvider i którego metoda GetFormat zwraca obiekt NumberFormatInfo, który udostępnia informacje o formatowaniu.
Jeśli provider
jest null
lub nie można uzyskać obiektu NumberFormatInfo z provider
, wartość zwracana dla tego wystąpienia jest sformatowana przy użyciu NumberFormatInfo 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
- standardowych ciągów formatu liczbowego
- niestandardowe ciągi formatu liczbowego
- Instrukcje: dopełnienie liczby zerami wiodącymi
- przykład : narzędzie formatowania winforms platformy .NET Core (C#)
- przykład : .NET Core WinForms Formatting Utility (Visual Basic)