Int32.ToString Metoda

Definice

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.Converts the numeric value of this instance to its equivalent string representation.

Přetížení

ToString(IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určených informací o formátování specifických pro jazykovou verzi.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu a informací o formátování specifických pro jazykovou verzi.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString()

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určených informací o formátování specifických pro jazykovou verzi.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.An object that supplies culture-specific formatting information.

Návraty

Řetězcové vyjádření hodnoty této instance, jak je určeno provider.The string representation of the value of this instance as specified by provider.

Implementuje

Příklady

Následující příklad zobrazuje řetězcové vyjádření Int32 hodnoty pomocí objektů CultureInfo, které reprezentují několik různých 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

Poznámky

Metoda ToString(IFormatProvider) formátuje hodnotu Int32 ve výchozím formátu ("G" nebo "Obecné") pomocí objektu NumberFormatInfo zadané jazykové verze.The ToString(IFormatProvider) method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Chcete-li zadat jiný formát nebo aktuální jazykovou verzi, použijte další přetížení metody ToString, a to následujícím způsobem:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

Parametr provider je objekt, který implementuje rozhraní IFormatProvider.The provider parameter is an object that implements the IFormatProvider interface. Jeho metoda GetFormat vrátí objekt NumberFormatInfo, který poskytuje informace specifické jazykové verze o formátu řetězce, který je vrácený touto metodou.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Objekt, který implementuje IFormatProvider může být kterýkoli z následujících:The object that implements IFormatProvider can be any of the following:

  • Objekt CultureInfo, který představuje jazykovou verzi, jejíž pravidla formátování se mají použít.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Objekt NumberFormatInfo, který obsahuje konkrétní informace o formátování čísel pro tuto hodnotu.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Vlastní objekt, který implementuje IFormatProvider a jehož metoda GetFormat vrací objekt NumberFormatInfo, který poskytuje informace o formátování.A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

Pokud je provider null nebo nelze získat objekt NumberFormatInfo ze provider, je návratová hodnota formátována pomocí objektu NumberFormatInfo pro aktuální jazykovou verzi vlákna.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. Informace o aktuální jazykové verzi vlákna naleznete v tématu Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Viz také

ToString(String, IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu a informací o formátování specifických pro jazykovou verzi.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

Standardní nebo vlastní řetězec číselného formátu.A standard or custom numeric format string.

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.An object that supplies culture-specific formatting information.

Návraty

Řetězcové vyjádření hodnoty této instance, jak je určeno format a provider.The string representation of the value of this instance as specified by format and provider.

Implementuje

Výjimky

format není platný nebo se nepodporuje.format is invalid or not supported.

Příklady

Následující příklad zobrazuje kladnou a zápornou hodnotu pomocí každého podporovaného specifikátoru standardního číselného formátu pro tři různé jazykové verze.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

Poznámky

Metoda ToString(String, IFormatProvider) formátuje hodnotu Int32 v zadaném formátu pomocí objektu NumberFormatInfo zadané jazykové verze.The ToString(String, IFormatProvider) method formats an Int32 value in a specified format by using the NumberFormatInfo object of a specified culture. Pokud chcete použít výchozí formát nebo nastavení jazykové verze, použijte další přetížení metody ToString, a to následujícím způsobem:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)

Parametr format může být buď standardní, nebo vlastní řetězec číselného formátu.The format parameter can be either a standard or a custom numeric format string. Jsou podporovány všechny standardní řetězce formátování čísel kromě "R" (nebo "r"), stejně jako všechny vlastní znaky číselného formátu.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Pokud je format null nebo prázdný řetězec (""), návratová hodnota této instance je formátována pomocí obecného specifikátoru číselného formátu ("G").If format is null or an empty string (""), the return value for this instance is formatted with the general numeric format specifier ("G").

Parametr provider je objekt, který implementuje rozhraní IFormatProvider.The provider parameter is an object that implements the IFormatProvider interface. Jeho metoda GetFormat vrátí objekt NumberFormatInfo, který poskytuje informace o formátu specifické jazykové verze o formátu řetězce, který je vrácený touto metodou.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. Objekt, který implementuje IFormatProvider může být kterýkoli z následujících:The object that implements IFormatProvider can be any of the following:

  • Objekt CultureInfo, který představuje jazykovou verzi, jejíž pravidla formátování se mají použít.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Objekt NumberFormatInfo, který obsahuje konkrétní informace o formátování čísel pro tuto hodnotu.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Vlastní objekt, který implementuje IFormatProvider a jehož metoda GetFormat vrací objekt NumberFormatInfo, který poskytuje informace o formátování.A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

Pokud je provider null nebo nelze získat objekt NumberFormatInfo ze provider, je návratová hodnota této instance formátována s NumberFormatInfo pro aktuální jazykovou verzi.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.

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Viz také

ToString(String)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu.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

Standardní nebo vlastní řetězec číselného formátu.A standard or custom numeric format string.

Návraty

Řetězcové vyjádření hodnoty této instance, jak je určeno format.The string representation of the value of this instance as specified by format.

Výjimky

format není platný nebo se nepodporuje.format is invalid or not supported.

Příklady

Následující příklad zobrazuje Int32 hodnotu pomocí každého podporovaného specifikátoru standardního číselného formátu společně se dvěma vlastními číselnými formátovacími řetězcemi.The following example displays an Int32 value using each of the supported standard numeric format specifiers, together with two custom numeric format strings. Při převodu číselných hodnot na řetězce používá tento příklad konvence formátování jazykové verze 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

Poznámky

Metoda ToString(String) formátuje hodnotu Int32 v zadaném formátu pomocí objektu NumberFormatInfo, který představuje konvence aktuální jazykové verze.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. Chcete-li použít výchozí formát ("G" nebo obecné ") nebo zadat jinou jazykovou verzi, použijte další přetížení metody ToString, a to následujícím způsobem: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:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

Parametr format může být libovolný platný standardní specifikátor číselného formátu s výjimkou "R", stejně jako libovolná kombinace specifikátorů vlastního číselného formátu.The format parameter can be any valid standard numeric format specifier except for "R", as well as any combination of custom numeric format specifiers. Pokud je format null nebo prázdný řetězec (""), návratová hodnota této instance je formátována pomocí obecného specifikátoru číselného formátu ("G").If format is null or an empty string (""), the return value of this instance is formatted with the general numeric format specifier ("G").

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Návratová hodnota této instance je formátována pomocí NumberFormatInfo pro aktuální jazykovou verzi.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Viz také

ToString()

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.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

Návraty

Řetězcová reprezentace hodnoty této instance, která se skládá z záporného znaménka v případě, že je hodnota záporná, a posloupnost číslic od 0 do 9 bez počátečních nul.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.

Příklady

Následující příklad zobrazuje Int32 hodnotu pomocí výchozí metody ToString().The following example displays an Int32 value using the default ToString() method. Zobrazuje také řetězcové reprezentace Int32 hodnoty, která je výsledkem použití několika standardních specifikátorů formátu.It also displays the string representations of the Int32 value that results from using a number of standard format specifiers. Příklady jsou zobrazeny pomocí konvencí formátování jazykové verze 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      

Poznámky

Metoda ToString() formátuje hodnotu Int32 ve výchozím formátu ("G" nebo "Obecné") pomocí objektu NumberFormatInfo aktuální jazykové verze.The ToString() method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Chcete-li určit jiný formát nebo jazykovou verzi, použijte další přetížení metody ToString, a to následujícím způsobem:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Viz také

Platí pro