Int32.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ę w postaci ciągu.
Przeciążenia
ToString() |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu. |
ToString(IFormatProvider) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury. |
ToString(String) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu. |
ToString(String, IFormatProvider) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu i informacji specyficznych dla kultury. |
ToString()
- Źródło:
- Int32.cs
- Źródło:
- Int32.cs
- Źródło:
- Int32.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Zwraca
Reprezentacja ciągu wartości tego wystąpienia składająca się z znaku ujemnego, jeśli wartość jest ujemna, oraz sekwencja cyfr z zakresu od 0 do 9 bez zer wiodących.
Przykłady
Poniższy przykład przedstawia Int32 wartość przy użyciu metody domyślnej ToString() . Wyświetla również reprezentacje ciągów Int32 wartości, która wynika z używania wielu standardowych specyfikatorów formatu. W przykładach jest używana konwencja formatowania kultury en-US.
using namespace System;
void main()
{
int value = -16325;
// Display value using 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:
// -16325
// -16325
// ($16,325.00)
// -16325
// -16325.00
// -16,325.00
// FFFFC03B
int value = -16325;
// Display value using default ToString method.
Console.WriteLine(value.ToString()); // Displays -16325
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")); // Displays -16325
Console.WriteLine(value.ToString("C")); // Displays ($16,325.00)
Console.WriteLine(value.ToString("D")); // Displays -16325
Console.WriteLine(value.ToString("F")); // Displays -16325.00
Console.WriteLine(value.ToString("N")); // Displays -16,325.00
Console.WriteLine(value.ToString("X")); // Displays FFFFC03B
let value = -16325
// Display value using default ToString method.
printfn $"{value.ToString()}" // Displays -16325
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}""" // Displays -16325
printfn $"""{value.ToString "C"}""" // Displays ($16,325.00)
printfn $"""{value.ToString "D"}""" // Displays -16325
printfn $"""{value.ToString "F"}""" // Displays -16325.00
printfn $"""{value.ToString "N"}""" // Displays -16,325.00
printfn $"""{value.ToString "X"}""" // Displays FFFFC03B
Dim value As Integer = -16325
' Display value using default ToString method.
Console.WriteLine(value.ToString()) ' Displays -16325
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")) ' Displays -16325
Console.WriteLine(value.ToString("C")) ' Displays ($16,325.00)
Console.WriteLine(value.ToString("D")) ' Displays -16325
Console.WriteLine(value.ToString("F")) ' Displays -16325.00
Console.WriteLine(value.ToString("N")) ' Displays -16,325.00
Console.WriteLine(value.ToString("X")) ' Displays FFFFC03B
Uwagi
Metoda ToString() formatuje Int32 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 opisana bardziej szczegółowo 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:
- Int32.cs
- Źródło:
- Int32.cs
- Źródło:
- Int32.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych 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
Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.
Zwraca
Reprezentacja ciągu wartości tego wystąpienia określona przez provider
parametr .
Implementuje
Przykłady
Poniższy przykład przedstawia reprezentację Int32 ciągu wartości przy użyciu CultureInfo obiektów reprezentujących kilka różnych kultur.
using namespace System;
using namespace System::Globalization;
void main()
{
int value = -16325;
// 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")));
}
// The example displays the following output:
// -16325
// -16325
// -16325
int value = -16325;
// 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:
// -16325
// -16325
// -16325
let value = -16325
// 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:
// -16325
// -16325
// -16325
Dim value As Integer = -16325
' 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:
' -16325
' -16325
' -16325
Uwagi
Metoda ToString(IFormatProvider) formatuje Int32 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 udostępnia informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę. Obiekt implementujący IFormatProvider może być dowolny z następujących elementów:
CultureInfo Obiekt reprezentujący kulturę, której reguły formatowania mają być używane.
NumberFormatInfo Obiekt zawierający określone informacje o formatowaniu liczbowym dla tej wartości.
Obiekt niestandardowy, który implementuje IFormatProvider i którego GetFormat metoda zwraca NumberFormatInfo obiekt, który udostępnia informacje o formatowaniu.
Jeśli provider
nie można uzyskać obiektu lub NumberFormatInfo obiektu z provider
klasy , zwracana wartość jest sformatowana przy użyciu NumberFormatInfo obiektu dla bieżącej kultury wątkunull
. Aby uzyskać informacje o bieżącej kulturze wątku, zobacz Thread.CurrentCulture.
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo 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:
- Int32.cs
- Źródło:
- Int32.cs
- Źródło:
- Int32.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego 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
Standardowy lub niestandardowy ciąg formatu liczbowego.
Zwraca
Reprezentacja ciągu wartości tego wystąpienia określona przez format
parametr .
Wyjątki
format
jest nieprawidłowy lub nie jest obsługiwany.
Przykłady
Poniższy przykład przedstawia Int32 wartość przy użyciu każdego z obsługiwanych standardowych specyfikatorów formatu liczbowego wraz z dwoma niestandardowymi ciągami formatu liczbowego. W celu przeliczenia wartości liczbowych na ciągi w przykładzie użyto konwencji formatowania kultury en-US.
using namespace System;
void main()
{
int value = -16325;
String^ specifier;
// Use standard numeric format specifiers.
specifier = "G";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
specifier = "C";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
specifier = "D8";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
specifier = "E4";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
specifier = "e3";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
specifier = "F";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
specifier = "N";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
specifier = "P";
Console::WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier));
specifier = "X";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Use custom numeric format specifiers.
specifier = "0,0.000";
Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
specifier = "#,#.00#;(#,#.00#)";
Console::WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
}
// The example displays the following output:
// G: -16325
// C: ($16,325.00)
// D8: -00016325
// E4: -1.6325E+004
// e3: -1.633e+004
// F: -16325.00
// N: -16,325.00
// P: 0.00 %
// X: FFFFC03B
// 0,0.000: -16,325.000
// #,#.00#;(#,#.00#): 16,325.00
int 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).ToString(specifier));
// Displays: P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays: X: FFFFC03B
// 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 = -16325
// 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}: {(value / 100000).ToString specifier}"
// Displays: P: -16.33 %
let specifier = "X"
printfn $"{specifier}: {value.ToString specifier}"
// Displays: X: FFFFC03B
// 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 * -1).ToString specifier}"
// Displays: #,#.00#;(#,#.00#): 16,325.00
Dim value As Integer = -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: FFFFC03B
' 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 Int32 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 lub null
pusty ciąg (""), zwracana wartość tego wystąpienia jest sformatowana za pomocą ogólnego specyfikatora formatu liczbowego ("G").
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo 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.
Wartość zwracana tego wystąpienia jest sformatowana przy użyciu NumberFormatInfo wartości dla bieżącej kultury.
Zobacz też
- Parse(String)
- String
- Typy formatowania na platformie .NET
- Standardowe ciągi formatów liczbowych
- Niestandardowe ciągi formatu liczbowego
- Instrukcje: Uzupełnianie liczby zerami wiodącymi
Dotyczy
ToString(String, IFormatProvider)
- Źródło:
- Int32.cs
- Źródło:
- Int32.cs
- Źródło:
- Int32.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu i informacji specyficznych 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
Standardowy lub niestandardowy ciąg formatu liczbowego.
- provider
- IFormatProvider
Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.
Zwraca
Ciąg reprezentacja wartości tego wystąpienia określona przez format
i provider
.
Implementuje
Wyjątki
format
jest nieprawidłowy lub nie jest obsługiwany.
Przykłady
Poniższy przykład przedstawia dodatnią i ujemną wartość przy użyciu każdego z obsługiwanych standardowych specyfikatorów formatu liczbowego dla trzech różnych kultur.
using namespace System;
using namespace System::Globalization;
void main()
{
// Define cultures whose formatting conventions are to be used.
array<CultureInfo^>^ cultures = { CultureInfo::CreateSpecificCulture("en-US"),
CultureInfo::CreateSpecificCulture("fr-FR"),
CultureInfo::CreateSpecificCulture("es-ES") };
int positiveNumber = 1679;
int negativeNumber = -3045;
array<String^>^ specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"};
for each (String^ specifier in specifiers)
{
for each (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:
// 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 FFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFF41B
// X8 format using es-ES culture: 0000068F FFFFF41B
// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
CultureInfo.CreateSpecificCulture("fr-FR"),
CultureInfo.CreateSpecificCulture("es-ES") };
int positiveNumber = 1679;
int negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "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:
// 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 FFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFF41B
// X8 format using es-ES culture: 0000068F FFFFF41B
// 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 = 1679
let negativeNumber = -3045
let specifiers = [ "G"; "C"; "D8"; "E2"; "F"; "N"; "P"; "X8" ]
for specifier in specifiers do
for culture in cultures do
// Display values format specifiers.
printfn $"{specifier} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"
printfn ""
// The example displays the following output:
// 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 FFFFF41B
// X8 format using fr-FR culture: 0000068F FFFFF41B
// X8 format using es-ES culture: 0000068F FFFFF41B
' 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 Integer = 1679
Dim negativeNumber As Integer = -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 FFFFF41B
' X8 format using fr-FR culture: 0000068F FFFFF41B
' X8 format using es-ES culture: 0000068F FFFFF41B
Uwagi
Metoda ToString(String, IFormatProvider) formatuje Int32 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 znaki niestandardowych formatów liczbowych. Jeśli format
jest lub null
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 udostępnia informacje o formacie specyficznym dla kultury dotyczące formatu ciągu zwracanego przez tę metodę. Obiekt implementujący IFormatProvider może być dowolny z następujących elementów:
CultureInfo Obiekt reprezentujący kulturę, której reguły formatowania mają być używane.
NumberFormatInfo Obiekt zawierający określone informacje o formatowaniu liczbowym dla tej wartości.
Obiekt niestandardowy, który implementuje IFormatProvider i którego GetFormat metoda zwraca NumberFormatInfo obiekt, który udostępnia informacje o formatowaniu.
Jeśli provider
nie można uzyskać obiektu lub NumberFormatInfo obiektu z provider
klasy , wartość zwracana dla tego wystąpienia jest sformatowana przy użyciu NumberFormatInfo wartości dla bieżącej null
kultury.
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo 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 formatu liczbowego
- Instrukcje: Uzupełnianie liczby zerami wiodącymi
- Przykład: .NET Core WinForms Formatting Utility (C#)
- Przykład: .NET Core WinForms Formatting Utility (Visual Basic)
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla