Int16.ToString Int16.ToString Int16.ToString Int16.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 formatting 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

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

Возвраты

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

Реализации

Примеры

В следующем примере выполняется итерация массива Int16 значений и отображение каждого из них в консоли путем Int16.ToString(IFormatProvider) вызова метода с различными поставщиками формата.The following example iterates an array of Int16 values and displays each of them to the console by calling the Int16.ToString(IFormatProvider) method with different format providers. Из-за простого форматирования, определенного описателем формата по умолчанию "G", отформатированные строки, Int16 создаваемые для каждого значения, идентичны, независимо от provider значения параметра.Because of the simple formatting defined by the default "G" format specifier, the formatted strings produced for each Int16 value are identical regardless of the value of the provider parameter.

short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("de-de"), 
                           new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0, 6} ({1})     ", 
                    int16Value.ToString(provider), 
                    provider.Name);
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
//            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
//        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
//        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)      
Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
   For Each provider As CultureInfo In providers
      Console.Write("{0, 6} ({1})     ", _
                    int16Value.ToString(provider), _
                    provider.Name)
   Next                     
   Console.WriteLine()
Next 
' The example displays the following output to the console:
'       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
'            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
'        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
'        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)      

Комментарии

Метод форматирует значение в формате по умолчанию ("G" или "общий" NumberFormatInfo ), используя объект указанной культуры. Int16 ToString(IFormatProvider)The ToString(IFormatProvider) method formats an Int16 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)

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

Параметр — это IFormatProvider.GetFormatреализация, метод которой возвращает объект.NumberFormatInfo IFormatProvider providerThe provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Как правило provider , NumberFormatInfo является объектом или CultureInfo объектом.Typically, provider is a NumberFormatInfo object or a CultureInfo object. NumberFormatInfo Объект предоставляет сведения о формате строки, возвращаемой этим методом, в зависимости от языка и региональных параметров.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. Если provider имеет nullзначение, этот NumberFormatInfo экземпляр форматируется с использованием объекта для текущего языка и региональных параметров.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

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

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

Реализации

Примеры

В следующем примере показано Int16 значение, использующее каждую из поддерживаемых стандартных строк стандартного формата в четырех различных культурах.The following example displays an Int16 value using each of the supported standard format strings in four different cultures.

Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1", 
                    "P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("de-de"), 
                           new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1], 
                  providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
   // Display the value for each provider on the same line.
   Console.Write("{0,-12}", format);
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0,12}  ", 
                    value.ToString(format, provider)); 
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//                       en-US         fr-FR         de-DE         es-ES
//    
//    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
//    D6                014603        014603        014603        014603  
//    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
//    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
//    F1               14603.0       14603,0       14603,0       14603,0  
//    G                  14603         14603         14603         14603  
//    N1              14,603.0      14 603,0      14.603,0      14.603,0  
//    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
//    X4                  390B          390B          390B          390B  
//    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
//    ##000.0          14603.0       14603,0       14603,0       14603,0  
Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
                  providers(2), providers(3))
Console.WriteLine()                        
' Display a value using each format string.
For Each format As String In formats
   ' Display the value for each provider on the same line.
   Console.Write("{0,-12}", format)
   For Each provider As CultureInfo In providers
      Console.Write("{0,12}  ", _
                    value.ToString(format, provider)) 
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'                       en-US         fr-FR         de-DE         es-ES
'    
'    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
'    D6                014603        014603        014603        014603  
'    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
'    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
'    F1               14603.0       14603,0       14603,0       14603,0  
'    G                  14603         14603         14603         14603  
'    N1              14,603.0      14 603,0      14.603,0      14.603,0  
'    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
'    X4                  390B          390B          390B          390B  
'    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
'    ##000.0          14603.0       14603,0       14603,0       14603,0  

Комментарии

Метод форматирует значение вNumberFormatInfo указанном формате, используя объект указанного языка и региональных параметров. Int16 ToString(String, IFormatProvider)The ToString(String, IFormatProvider) method formats an Int16 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 string returned by this method 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:

provider ПараметрIFormatProvider является реализацией.The provider parameter is an IFormatProvider implementation. Его 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интерфейс.A custom object that implements IFormatProvider.

Если provider параметр nullимеет значение или NumberFormatInfo объект не может быть получен providerиз, возвращаемое значения форматируется с NumberFormatInfo помощью для текущего языка и региональных параметров.If provider is null, or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted with the NumberFormatInfo for the current culture.

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

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 numeric format string.

Возвраты

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

Примеры

В следующем примере инициализируются два Int16 значения и отображаются в консоли с использованием каждой из поддерживаемых стандартных строк стандартного формата и нескольких строк настраиваемого формата.The following example initializes two Int16 values and displays them to the console using each of the supported standard format strings and several custom format strings. Пример выполняется с EN-US в качестве текущего языка и региональных параметров.The example is run with en-US as the current culture.

Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1", 
                    "P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}",  
                     format, 
                     values[0].ToString(format), 
                     values[1].ToString(format));
}                                                               
// The example displays the following output to the console:
//    'C4' format specifier:    ($23,805.0000)        $32,194.0000
//    'D6' format specifier:           -023805              032194
//    'e1' format specifier:         -2.4e+004            3.2e+004
//    'E2' format specifier:        -2.38E+004           3.22E+004
//    'F1' format specifier:          -23805.0             32194.0
//    ' G' format specifier:            -23805               32194
//    'N1' format specifier:         -23,805.0            32,194.0
//    'P0' format specifier:      -2,380,500 %         3,219,400 %
//    'X4' format specifier:              A303                7DC2
//    '000000.0000' format specifier:      -023805.0000         032194.0000
//    '##000.0' format specifier:          -23805.0             32194.0      
Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}", _ 
                     format, _
                     values(0).ToString(format), _
                     values(1).ToString(format))
Next                                                               
' The example displays the following output to the console:
'    'C4' format specifier:    ($23,805.0000)        $32,194.0000
'    'D6' format specifier:           -023805              032194
'    'e1' format specifier:         -2.4e+004            3.2e+004
'    'E2' format specifier:        -2.38E+004           3.22E+004
'    'F1' format specifier:          -23805.0             32194.0
'    ' G' format specifier:            -23805               32194
'    'N1' format specifier:         -23,805.0            32,194.0
'    'P0' format specifier:      -2,380,500 %         3,219,400 %
'    'X4' format specifier:              A303                7DC2
'    '000000.0000' format specifier:      -023805.0000         032194.0000
'    '##000.0' format specifier:          -23805.0             32194.0      

Комментарии

Метод форматирует значение вNumberFormatInfo указанном формате с помощью объекта, представляющего соглашения о текущем языке и региональных Int16параметрах ToString(String) .The ToString(String) method formats an Int16 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 Параметр может быть либо стандартной, либо строкой настраиваемого числового формата.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 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 minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Примеры

В следующем примере ToString() метод используется для вывода на консоль Int16 массива значений.The following example uses the ToString() method to display an array of Int16 values to the console.

short[] numbers = {0, 14624, 13982, short.MaxValue, 
                   short.MinValue, -16667};
foreach (short number in numbers)
{
   Console.WriteLine(number.ToString());
}            
// The example displays the following output to the console:
//       0
//       14624
//       13982
//       32767
//       -32768
//       -16667                             
Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
                         Short.MinValue, -16667}
For Each number As Short In numbers
   Console.WriteLine(number.ToString())
Next        
' The example displays the following output to the console:
'       0
'       14624
'       13982
'       32767
'       -32768
'       -16667                             

Комментарии

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

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

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