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

Определение

Преобразовывает числовое значение данного экземпляра в эквивалентное ему строковое представление.Converts the numeric value of this instance to its equivalent string representation.

Перегрузки

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.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)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.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)

Преобразует числовое значение данного экземпляра в эквивалентное строковое представление с использованием указанного формата.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

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

Преобразовывает числовое значение данного экземпляра в эквивалентное ему строковое представление.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.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

Параметры

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.An object that supplies culture-specific formatting information.

Возвраты

Строковое представление значения данного экземпляра, определяемое параметром provider.The string representation of the value of this instance as specified by provider.

Реализации

Примеры

В следующем примере показано строковое представление Int32 значения с помощью CultureInfo объектов, представляющих различные языки и региональные параметры.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

Комментарии

Метод форматирует значение в формате по умолчанию ("G" или "общий" NumberFormatInfo ), используя объект указанной культуры. Int32 ToString(IFormatProvider)The ToString(IFormatProvider) method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Если необходимо указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Использование форматаTo use format Для языка и региональных параметровFor culture Использование перегрузкиUse the overload
Формат по умолчанию ("G")Default ("G") format Культура по умолчанию (текущий)Default (current) culture ToString()
Конкретный форматA specific format Культура по умолчанию (текущий)Default (current) culture ToString(String)
Конкретный форматA specific format Конкретный язык и региональные параметрыA specific culture ToString(String, IFormatProvider)

Параметр — это объект, IFormatProvider реализующий интерфейс. providerThe provider parameter is an object that implements the IFormatProvider interface. Его GetFormat методNumberFormatInfo возвращает объект, предоставляющий сведения о формате строки, возвращаемой этим методом, в зависимости от языка и региональных параметров.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Объект, реализующий IFormatProvider , может быть любым из следующих:The object that implements IFormatProvider can be any of the following:

  • CultureInfo Объект, представляющий язык и региональные параметры, правила форматирования которых будут использоваться.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfo Объект, содержащий конкретные сведения о форматировании для этого значения.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Пользовательский объект, реализующий IFormatProvider GetFormat метод и, который возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

Если provider параметр null имеет значение NumberFormatInfo или объект не может быть providerполучен из, возвращаемые значения форматируются с NumberFormatInfo использованием объекта для текущего языка и региональных параметров потока.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. Сведения о текущем языке и региональных параметрах потока Thread.CurrentCultureсм. в разделе.For information about the thread current culture, see Thread.CurrentCulture.

.NET Framework обеспечивает обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Дополнительно

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.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

Параметры

format
String String String String

Стандартная или пользовательская строка числового формата.A standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.An object that supplies culture-specific formatting information.

Возвраты

Строковое представление значения данного экземпляра, определяемое параметрами format и provider.The string representation of the value of this instance as specified by format and provider.

Реализации

Исключения

format является недопустимым или не поддерживается.format is invalid or not supported.

Примеры

В следующем примере отображается положительное и отрицательное значение, использующее каждый из поддерживаемых стандартных описателей числового формата для трех различных языков и региональных параметров.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

Комментарии

Метод форматирует значение вNumberFormatInfo указанном формате, используя объект указанного языка и региональных параметров. Int32 ToString(String, IFormatProvider)The ToString(String, IFormatProvider) method formats an Int32 value in a specified format by using the NumberFormatInfo object of a specified culture. Если вы хотите использовать формат по умолчанию или параметры языка и региональных параметров, используйте другие перегрузки ToString метода следующим образом:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Использование форматаTo use format Для языка и региональных параметровFor culture Использование перегрузкиUse the overload
Формат по умолчанию ("G")Default ("G") format Культура по умолчанию (текущий)Default (current) culture ToString()
Формат по умолчанию ("G")Default ("G") format Конкретный язык и региональные параметрыA specific culture ToString(IFormatProvider)
Конкретный форматA specific format Культура по умолчанию (текущий)Default (current) culture ToString(String)

format Параметр может быть либо стандартной, либо строкой настраиваемого числового формата.The format parameter can be either a standard or a custom numeric format string. Поддерживаются все строки стандартного числового формата, отличные от "R" (или "r"), как и все пользовательские символы числового формата.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Если format параметр null имеет значение или является пустой строкой (""), то возвращаемые значения для этого экземпляра форматируются с помощью описателя общего числового формата ("G").If format is null or an empty string (""), the return value for this instance is formatted with the general numeric format specifier ("G").

Параметр — это объект, IFormatProvider реализующий интерфейс. providerThe provider parameter is an object that implements the IFormatProvider interface. Его GetFormat методNumberFormatInfo возвращает объект, предоставляющий сведения о формате строки, возвращаемой этим методом, для определенного языка и региональных параметров.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. Объект, реализующий IFormatProvider , может быть любым из следующих:The object that implements IFormatProvider can be any of the following:

  • CultureInfo Объект, представляющий язык и региональные параметры, правила форматирования которых будут использоваться.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfo Объект, содержащий конкретные сведения о форматировании для этого значения.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Пользовательский объект, реализующий IFormatProvider GetFormat метод и, который возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

Если provider параметр null имеет значение NumberFormatInfo или объект не может быть providerполучен из NumberFormatInfo , возвращаемым значением для этого экземпляра будет отформатировано для текущего языка и региональных параметров.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.

.NET Framework обеспечивает обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Дополнительно

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

Преобразует числовое значение данного экземпляра в эквивалентное строковое представление с использованием указанного формата.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

Параметры

format
String String String String

Стандартная или пользовательская строка числового формата.A standard or custom numeric format string.

Возвраты

Строковое представление значения данного экземпляра, определяемое параметром format.The string representation of the value of this instance as specified by format.

Исключения

format является недопустимым или не поддерживается.format is invalid or not supported.

Примеры

В следующем примере отображается Int32 значение с использованием каждого из поддерживаемых стандартных описателей числового формата вместе с двумя строками настраиваемого числового формата.The following example displays an Int32 value using each of the supported standard numeric format specifiers, together with two custom numeric format strings. При преобразовании числовых значений в строки в примере используются соглашения о форматировании для языка и региональных параметров 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

Комментарии

Метод форматирует значение вNumberFormatInfo указанном формате с помощью объекта, представляющего соглашения о текущем языке и региональных Int32параметрах ToString(String) .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. Если вы хотите использовать формат по умолчанию ("G" или "общий") или указать другой язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом: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:

Использование форматаTo use format Для языка и региональных параметровFor culture Использование перегрузкиUse the overload
Формат по умолчанию ("G")Default ("G") format Культура по умолчанию (текущий)Default (current) culture ToString()
Формат по умолчанию ("G")Default ("G") format Конкретный язык и региональные параметрыA specific culture ToString(IFormatProvider)
Конкретный форматA specific format Конкретный язык и региональные параметрыA specific culture ToString(String, IFormatProvider)

format Параметр может быть любым допустимым описателем стандартного числового формата, за исключением "R", а также любым сочетанием описателей настраиваемого числового формата.The format parameter can be any valid standard numeric format specifier except for "R", as well as any combination of custom numeric format specifiers. Если format параметр null имеет значение или является пустой строкой (""), то возвращаемое значением этого экземпляра будет отформатировано с помощью описателя общего числового формата ("G").If format is null or an empty string (""), the return value of this instance is formatted with the general numeric format specifier ("G").

.NET Framework обеспечивает обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Возвращаемое значение этого экземпляра форматируется с помощью NumberFormatInfo для текущего языка и региональных параметров.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Дополнительно

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

Преобразовывает числовое значение данного экземпляра в эквивалентное ему строковое представление.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

Возвраты

Строковое представление значения данного экземпляра, состоящее из знака минус, если число отрицательное, и последовательности цифр в диапазоне от 0 до 9 с ненулевой первой цифрой.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.

Примеры

В следующем примере показано Int32 значение с помощью метода по умолчанию. ToString()The following example displays an Int32 value using the default ToString() method. Он также отображает строковые представления Int32 значения, полученные в результате использования ряда стандартных описателей формата.It also displays the string representations of the Int32 value that results from using a number of standard format specifiers. Примеры отображаются с использованием соглашений о форматировании языка и региональных параметров 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      

Комментарии

Метод форматирует значение в формате по умолчанию ("G" или "общий" NumberFormatInfo ), используя объект текущего языка и региональных параметров. Int32 ToString()The ToString() method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Если необходимо указать другой формат или язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Использование форматаTo use format Для языка и региональных параметровFor culture Использование перегрузкиUse the overload
Формат по умолчанию ("G")Default ("G") format Конкретный язык и региональные параметрыA specific culture ToString(IFormatProvider)
Конкретный форматA specific format Культура по умолчанию (текущий)Default (current) culture ToString(String)
Конкретный форматA specific format Конкретный язык и региональные параметрыA specific culture ToString(String, IFormatProvider)

.NET Framework обеспечивает обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Дополнительно

Применяется к