Int32.ToString Int32.ToString Int32.ToString Int32.ToString Method

Definicja

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

Przeciążenia

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString() ToString() ToString() ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public:
 virtual System::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 IFormatProvider IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.An object that supplies culture-specific formatting information.

Zwraca

Ciąg reprezentujący wartość tego wystąpienia określony przez provider.The string representation of the value of this instance as specified by provider.

Implementuje

Przykłady

Poniższy przykład wyświetla ciąg reprezentujący Int32 wartości przy użyciu CultureInfo obiektami, które reprezentują kilka różnych kultur.The following example displays the string representation of an Int32 value using CultureInfo objects that represent several different cultures.

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

ToString(IFormatProvider) Formaty metoda Int32 wartości domyślnej ("G" lub ogólne) format za pomocą NumberFormatInfo obiektu określonej kultury.The ToString(IFormatProvider) method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Jeśli chcesz określić inny format lub bieżącej kultury, należy używać innych przeciążeń ToString metody w następujący sposób:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Format domyślny ("G")Default ("G") format (Domyślne bieżącej) kulturyDefault (current) culture ToString()
Określony formatA specific format (Domyślne bieżącej) kulturyDefault (current) culture ToString(String)
Określony formatA specific format Określonej kulturyA specific culture ToString(String, IFormatProvider)

provider Parametru jest obiektem, który implementuje IFormatProvider interfejsu.The provider parameter is an object that implements the IFormatProvider interface. Jego GetFormat metoda zwraca NumberFormatInfo obiektu, który dostarcza informacje specyficzne dla kultury o formacie ciągu, który jest zwracany przez tę metodę.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Obiekt, który implementuje IFormatProvider może być dowolną z następujących czynności:The object that implements IFormatProvider can be any of the following:

  • Element CultureInfo obiektu, który reprezentuje kulturę, której reguły formatowania mają zostać użyte.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • A NumberFormatInfo obiekt, który zawiera określone informacje o formatowaniu liczb dla tej wartości.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Niestandardowy obiekt, który implementuje IFormatProvider i którego GetFormat metoda zwraca NumberFormatInfo obiekt, który dostarcza informacje o formatowaniu.A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

Jeśli provider jest null lub NumberFormatInfo obiektu nie można uzyskać z provider, wartość zwracana jest formatowana przy użyciu NumberFormatInfo obiektu dla bieżącej kultury wątku.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. Aby uzyskać informacje o bieżącej kultury wątku, zobacz Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Zobacz też

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parametry

format
String String String String

Standardowy lub niestandardowy ciąg formatu liczbowego.A standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.An object that supplies culture-specific formatting information.

Zwraca

Ciąg reprezentujący wartość tego wystąpienia określony przez format i provider.The string representation of the value of this instance as specified by format and provider.

Implementuje

Wyjątki

format jest nieprawidłowy lub nieobsługiwany.format is invalid or not supported.

Przykłady

Poniższy przykład wyświetla dodatnie i ujemne przy użyciu wszystkich specyfikatorów standardowego formatu liczb obsługiwanych dla trzech różnych kultur.The following example displays a positive and a negative value using each of the supported standard numeric format specifiers for three different cultures.

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

ToString(String, IFormatProvider) Formaty metoda Int32 wartości w określonym formacie za pomocą NumberFormatInfo obiektu określonej kultury.The ToString(String, IFormatProvider) method formats an Int32 value in a specified format by using the NumberFormatInfo object of a specified culture. Jeśli chcesz użyć ustawień domyślnych formatu lub kultury, należy używać innych przeciążeń ToString metody w następujący sposób:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Format domyślny ("G")Default ("G") format (Domyślne bieżącej) kulturyDefault (current) culture ToString()
Format domyślny ("G")Default ("G") format Określonej kulturyA specific culture ToString(IFormatProvider)
Określony formatA specific format (Domyślne bieżącej) kulturyDefault (current) culture ToString(String)

format Parametr może być standardowym lub niestandardowym ciągiem formatu liczbowego.The format parameter can be either a standard or a custom numeric format string. Obsługiwane są wszystkie standardowe ciągi formatu liczbowego inne niż „R” (lub „r”), podobnie jak wszystkie znaki niestandardowych formatów liczbowych.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Jeśli format jest null ani być pustym ciągiem (""), wartość zwracana dla tego wystąpienia jest sformatowany za pomocą ogólnego specyfikatora formatu liczbowego ("G").If format is null or an empty string (""), the return value for this instance is formatted with the general numeric format specifier ("G").

provider Parametru jest obiektem, który implementuje IFormatProvider interfejsu.The provider parameter is an object that implements the IFormatProvider interface. Jego GetFormat metoda zwraca NumberFormatInfo obiektu, który zawiera formatowanie specyficzne dla kultury informacje o formacie ciągu, który jest zwracany przez tę metodę.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific format information about the format of the string that is returned by this method. Obiekt, który implementuje IFormatProvider może być dowolną z następujących czynności:The object that implements IFormatProvider can be any of the following:

  • Element CultureInfo obiektu, który reprezentuje kulturę, której reguły formatowania mają zostać użyte.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • A NumberFormatInfo obiekt, który zawiera określone informacje o formatowaniu liczb dla tej wartości.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Niestandardowy obiekt, który implementuje IFormatProvider i którego GetFormat metoda zwraca NumberFormatInfo obiekt, który dostarcza informacje o formatowaniu.A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

Jeśli provider jest null lub NumberFormatInfo obiektu nie można uzyskać z provider, wartość zwracana dla tego wystąpienia jest formatowana przy użyciu NumberFormatInfo dla bieżącej kultury.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value for this instance is formatted with the NumberFormatInfo for the current culture.

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Zobacz też

ToString(String) ToString(String) ToString(String) ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parametry

format
String String String String

Standardowy lub niestandardowy ciąg formatu liczbowego.A standard or custom numeric format string.

Zwraca

Ciąg reprezentujący wartość tego wystąpienia określony przez format.The string representation of the value of this instance as specified by format.

Wyjątki

format jest nieprawidłowy lub nieobsługiwany.format is invalid or not supported.

Przykłady

Poniższy przykład wyświetla Int32 wartość każdej specyfikatorów standardowego formatu liczb obsługiwanych wraz z dwa ciągi niestandardowego formatu liczb.The following example displays an Int32 value using each of the supported standard numeric format specifiers, together with two custom numeric format strings. W celu przeliczenia wartości liczbowych na ciągi w przykładzie użyto konwencji formatowania kultury en-US.In converting the numeric values to strings, the example uses the formatting conventions of the en-US culture.

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

ToString(String) Formaty metoda Int32 wartości w określonym formacie za pomocą NumberFormatInfo obiekt, który reprezentuje konwencje bieżącej kultury.The ToString(String) method formats an Int32 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Jeśli chcesz użyć domyślnej ("G" lub ogólne) format lub określić inną kulturę, używać innych przeciążeń ToString metody w następujący sposób:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Format domyślny ("G")Default ("G") format (Domyślne bieżącej) kulturyDefault (current) culture ToString()
Format domyślny ("G")Default ("G") format Określonej kulturyA specific culture ToString(IFormatProvider)
Określony formatA specific format Określonej kulturyA specific culture ToString(String, IFormatProvider)

format Parametr może być dowolnym prawidłowy standardowy specyfikator formatu liczbowego z wyjątkiem "R", a także dowolna kombinacja niestandardowych specyfikatorów formatu liczbowego.The format parameter can be any valid standard numeric format specifier except for "R", as well as any combination of custom numeric format specifiers. Jeśli format jest null ani być pustym ciągiem (""), wartość zwracana przez to wystąpienie jest sformatowana za pomocą ogólnego specyfikatora formatu liczbowego ("G").If format is null or an empty string (""), the return value of this instance is formatted with the general numeric format specifier ("G").

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Wartość zwracana przez to wystąpienie jest formatowana przy użyciu NumberFormatInfo dla bieżącej kultury.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Zobacz też

ToString() ToString() ToString() ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Zwraca

Ciąg reprezentujący wartość tego wystąpienia, składający się z minus, jeśli wartość jest liczbą ujemną, a sekwencja cyfr od 0 do 9 z nie wiodącego zera.The string representation of the value of this instance, consisting of a negative sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Przykłady

Poniższy przykład wyświetla Int32 wartości przy użyciu domyślnego ToString() metody.The following example displays an Int32 value using the default ToString() method. Wyświetla również ciągów reprezentujących Int32 wartość będącą wynikiem przy użyciu szeregu specyfikatory formatu standardowego.It also displays the string representations of the Int32 value that results from using a number of standard format specifiers. W przykładach jest używana konwencja formatowania kultury en-US.The examples are displayed using the formatting conventions of the en-US culture.

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

ToString() Formaty metoda Int32 wartości domyślnej ("G" lub ogólne) format za pomocą NumberFormatInfo obiekt bieżącej kultury.The ToString() method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Jeśli chcesz określić inny format lub kultury, należy używać innych przeciążeń ToString metody w następujący sposób:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Format domyślny ("G")Default ("G") format Określonej kulturyA specific culture ToString(IFormatProvider)
Określony formatA specific format (Domyślne bieżącej) kulturyDefault (current) culture ToString(String)
Określony formatA specific format Określonej kulturyA specific culture ToString(String, IFormatProvider)

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Zobacz też

Dotyczy