SByte.ToString Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
Перегрузки
ToString() |
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление. |
ToString(IFormatProvider) |
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров. |
ToString(String) |
Преобразует числовое значение данного экземпляра в эквивалентное строковое представление с использованием указанного формата. |
ToString(String, IFormatProvider) |
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров. |
ToString()
- Исходный код:
- SByte.cs
- Исходный код:
- SByte.cs
- Исходный код:
- SByte.cs
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Возвращаемое значение
Строковое представление значения данного экземпляра, состоящее из знака минус, если число отрицательное, и последовательности цифр в диапазоне от 0 до 9 с ненулевой первой цифрой.
Примеры
В следующем примере отображается SByte значение с помощью метода по умолчанию ToString() . Он также отображает строковые представления значения, полученного SByte в результате использования ряда описателей стандартного формата. Примеры отображаются с использованием соглашений о форматировании языка и региональных параметров en-US.
using System;
public class Example
{
public static void Main()
{
sbyte value = -123;
// Display value using default ToString method.
Console.WriteLine(value.ToString()); // Displays -123
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")); // Displays -123
Console.WriteLine(value.ToString("C")); // Displays ($-123.00)
Console.WriteLine(value.ToString("D")); // Displays -123
Console.WriteLine(value.ToString("F")); // Displays -123.00
Console.WriteLine(value.ToString("N")); // Displays -123.00
Console.WriteLine(value.ToString("X")); // Displays 85
}
}
let value = -123y
// Display value using default ToString method.
printfn $"{value.ToString()}" // Displays -123
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}""" // Displays -123
printfn $"""{value.ToString "C"}""" // Displays ($-123.00)
printfn $"""{value.ToString "D"}""" // Displays -123
printfn $"""{value.ToString "F"}""" // Displays -123.00
printfn $"""{value.ToString "N"}""" // Displays -123.00
printfn $"""{value.ToString "X"}""" // Displays 85
Module Example
Public Sub Main()
Dim value As SByte = -123
' Display value using default ToString method.
Console.WriteLine(value.ToString()) ' Displays -123
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")) ' Displays -123
Console.WriteLine(value.ToString("C")) ' Displays ($-123.00)
Console.WriteLine(value.ToString("D")) ' Displays -123
Console.WriteLine(value.ToString("F")) ' Displays -123.00
Console.WriteLine(value.ToString("N")) ' Displays -123.00
Console.WriteLine(value.ToString("X")) ' Displays 85
End Sub
End Module
Комментарии
Метод ToString() форматирует SByte значение в формате по умолчанию ("G" или "общий") текущего языка и региональных параметров. Если вы хотите указать другой формат или язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:
Использование формата | Для языка и региональных параметров | Использование перегрузки |
---|---|---|
Формат по умолчанию ("G") | Определенный язык и региональные параметры | ToString(IFormatProvider) |
Определенный формат | Язык и региональные параметры по умолчанию (текущий) | ToString(String) |
Определенный формат | Определенный язык и региональные параметры | ToString(String, IFormatProvider) |
Возвращаемое значение форматируется с помощью описателя общего числового SByte формата ("G"). Строковое представление значения включает отрицательный знак, если его значение отрицательное, и последовательность цифр в диапазоне от 0 до 9 без начальных нулей. Отрицательный знак определяется NumberFormatInfo объектом для текущего языка и региональных параметров.
Чтобы определить форматирование строкового представления значения со знаком, вызовите ToString(String) метод .
См. также раздел
- Типы форматирования в .NET
- Строки стандартных числовых форматов
- Строки настраиваемых числовых форматов
Применяется к
ToString(IFormatProvider)
- Исходный код:
- SByte.cs
- Исходный код:
- SByte.cs
- Исходный код:
- SByte.cs
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
public:
virtual System::String ^ ToString(IFormatProvider ^ provider);
public:
System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider? provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String
Параметры
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Строковое представление значения данного экземпляра, определяемое параметром provider
.
Реализации
Примеры
В следующем примере определяется пользовательский NumberFormatInfo объект и присваивается его свойству NegativeSign символ "~". Затем в примере используется этот пользовательский объект, а также NumberFormatInfo объект инвариантного языка и региональных параметров для форматирования ряда значений SByte .
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define a custom NumberFormatInfo object with "~" as its negative sign.
NumberFormatInfo nfi = new NumberFormatInfo();
nfi.NegativeSign = "~";
// Initialize an array of SByte values.
sbyte[] bytes = { -122, 17, 124 };
// Display the formatted result using the custom provider.
Console.WriteLine("Using the custom NumberFormatInfo object:");
foreach (sbyte value in bytes)
Console.WriteLine(value.ToString(nfi));
Console.WriteLine();
// Display the formatted result using the invariant culture.
Console.WriteLine("Using the invariant culture:");
foreach (sbyte value in bytes)
Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo));
}
}
// The example displays the following output:
// Using the custom NumberFormatInfo object:
// ~122
// 17
// 124
//
// Using the invariant culture:
// -122
// 17
// 124
open System.Globalization
// Define a custom NumberFormatInfo object with "~" as its negative sign.
let nfi = NumberFormatInfo(NegativeSign = "~")
// Initialize an array of SByte values.
let bytes = [| -122y; 17y; 124y |]
// Display the formatted result using the custom provider.
printfn "Using the custom NumberFormatInfo object:"
for value in bytes do
printfn $"{value.ToString nfi}"
printfn ""
// Display the formatted result using the invariant culture.
printfn "Using the invariant culture:"
for value in bytes do
printfn $"{value.ToString NumberFormatInfo.InvariantInfo}"
// The example displays the following output:
// Using the custom NumberFormatInfo object:
// ~122
// 17
// 124
//
// Using the invariant culture:
// -122
// 17
// 124
Imports System.Globalization
Module Example
Public Sub Main()
' Define a custom NumberFormatInfo object with "~" as its negative sign.
Dim nfi As New NumberFormatInfo()
nfi.NegativeSign = "~"
' Initialize an array of SByte values.
Dim bytes() As SByte = { -122, 17, 124 }
' Display the formatted result using the custom provider.
Console.WriteLine("Using the custom NumberFormatInfo object:")
For Each value As SByte In bytes
Console.WriteLine(value.ToString(nfi))
Next
Console.WriteLine()
' Display the formatted result using the invariant culture.
Console.WriteLine("Using the invariant culture:")
For Each value As SByte In bytes
Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo))
Next
End Sub
End Module
' The example displays the following output:
' Using the custom NumberFormatInfo object:
' ~122
' 17
' 124
'
' Using the invariant culture:
' -122
' 17
' 124
Комментарии
Метод ToString(IFormatProvider) форматирует SByte значение в формате по умолчанию ("G" или "общий") указанного языка и региональных параметров. Если вы хотите указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:
Использование формата | Для языка и региональных параметров | Использование перегрузки |
---|---|---|
Формат по умолчанию ("G") | Язык и региональные параметры по умолчанию (текущий) | ToString() |
Определенный формат | Язык и региональные параметры по умолчанию (текущий) | ToString(String) |
Определенный формат | Определенный язык и региональные параметры | ToString(String, IFormatProvider) |
Параметр provider
является реализацией IFormatProvider . Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о формате строки, возвращаемой этим методом, с учетом языка и региональных параметров. Если provider
имеет значение null
, SByte значение форматируется с использованием NumberFormatInfo объекта текущего языка и региональных параметров. Единственным свойством NumberFormatInfo объекта , который управляет строковым представлением SByte значения с помощью описателя общего формата, является NumberFormatInfo.NegativeSign, который определяет символ, представляющий знак "минус".
Параметр provider
может иметь один из следующих значений:
Объект CultureInfo , представляющий язык и региональные параметры, предоставляющие сведения о форматировании.
Объект NumberFormatInfo , предоставляющий сведения о форматировании.
Пользовательский объект, реализующий IFormatProvider. Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о форматировании.
См. также раздел
- Типы форматирования в .NET
- Строки стандартных числовых форматов
- Строки настраиваемых числовых форматов
Применяется к
ToString(String)
- Исходный код:
- SByte.cs
- Исходный код:
- SByte.cs
- Исходный код:
- SByte.cs
Преобразует числовое значение данного экземпляра в эквивалентное строковое представление с использованием указанного формата.
public:
System::String ^ ToString(System::String ^ format);
public string ToString (string format);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String
Параметры
- format
- String
Стандартная или пользовательская строка числового формата.
Возвращаемое значение
Строковое представление значения данного экземпляра, определяемое параметром format
.
Исключения
format
недопустим.
Примеры
В следующем примере инициализируется массив значений и отображается с помощью каждой строки стандартного SByte формата и некоторых строк настраиваемого формата.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
sbyte[] values = { -124, 0, 118 };
string[] specifiers = { "G", "C", "D3", "E2", "e3", "F",
"N", "P", "X", "00.0", "#.0",
"000;(0);**Zero**" };
foreach (sbyte value in values)
{
foreach (string specifier in specifiers)
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
Console.WriteLine();
}
}
}
// The example displays the following output:
// G: -124
// C: ($124.00)
// D3: -124
// E2: -1.24E+002
// e3: -1.240e+002
// F: -124.00
// N: -124.00
// P: -12,400.00 %
// X: 84
// 00.0: -124.0
// #.0: -124.0
// 000;(0);**Zero**: (124)
//
// G: 0
// C: $0.00
// D3: 000
// E2: 0.00E+000
// e3: 0.000e+000
// F: 0.00
// N: 0.00
// P: 0.00 %
// X: 0
// 00.0: 00.0
// #.0: .0
// 000;(0);**Zero**: **Zero**
//
// G: 118
// C: $118.00
// D3: 118
// E2: 1.18E+002
// e3: 1.180e+002
// F: 118.00
// N: 118.00
// P: 11,800.00 %
// X: 76
// 00.0: 118.0
// #.0: 118.0
// 000;(0);**Zero**: 118
let values = [| -124y; 0y; 118y |]
let specifiers =
[| "G"; "C"; "D3"; "E2"; "e3"; "F"
"N"; "P"; "X"; "00.0"; "#.0"
"000(0)**Zero**" |]
for value in values do
for specifier in specifiers do
printfn $"{specifier}: {value.ToString specifier}"
printfn ""
// The example displays the following output:
// G: -124
// C: ($124.00)
// D3: -124
// E2: -1.24E+002
// e3: -1.240e+002
// F: -124.00
// N: -124.00
// P: -12,400.00 %
// X: 84
// 00.0: -124.0
// #.0: -124.0
// 000(0)**Zero**: (124)
//
// G: 0
// C: $0.00
// D3: 000
// E2: 0.00E+000
// e3: 0.000e+000
// F: 0.00
// N: 0.00
// P: 0.00 %
// X: 0
// 00.0: 00.0
// #.0: .0
// 000(0)**Zero**: **Zero**
//
// G: 118
// C: $118.00
// D3: 118
// E2: 1.18E+002
// e3: 1.180e+002
// F: 118.00
// N: 118.00
// P: 11,800.00 %
// X: 76
// 00.0: 118.0
// #.0: 118.0
// 000(0)**Zero**: 118
Imports System.Globalization
Module Example
Public Sub Main()
Dim values() As SByte = { -124, 0, 118 }
Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
"N", "P", "X", "00.0", "#.0", _
"000;(0);**Zero**" }
For Each value As SByte In values
For Each specifier As String In specifiers
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' G: -124
' C: ($124.00)
' D3: -124
' E2: -1.24E+002
' e3: -1.240e+002
' F: -124.00
' N: -124.00
' P: -12,400.00 %
' X: 84
' 00.0: -124.0
' #.0: -124.0
' 000;(0);**Zero**: (124)
'
' G: 0
' C: $0.00
' D3: 000
' E2: 0.00E+000
' e3: 0.000e+000
' F: 0.00
' N: 0.00
' P: 0.00 %
' X: 0
' 00.0: 00.0
' #.0: .0
' 000;(0);**Zero**: **Zero**
'
' G: 118
' C: $118.00
' D3: 118
' E2: 1.18E+002
' e3: 1.180e+002
' F: 118.00
' N: 118.00
' P: 11,800.00 %
' X: 76
' 00.0: 118.0
' #.0: 118.0
' 000;(0);**Zero**: 118
Комментарии
Метод ToString(String) форматирует SByte значение в указанном формате, используя соглашения текущего языка и региональных параметров. Если вы хотите использовать формат по умолчанию ("G" или общий) или указать другой язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:
Использование формата | Для языка и региональных параметров | Использование перегрузки |
---|---|---|
Формат по умолчанию ("G") | Язык и региональные параметры по умолчанию (текущий) | ToString() |
Формат по умолчанию ("G") | Определенный язык и региональные параметры | ToString(IFormatProvider) |
Определенный формат | Определенный язык и региональные параметры | ToString(String, IFormatProvider) |
Параметром format
может быть любой допустимый описатель стандартного числового формата или любое сочетание описателей настраиваемых числовых форматов. Если format
равно String.Empty или равно null
, возвращаемое значение текущего SByte объекта форматируется с помощью описателя общего формата ("G"). Если format
является любым другим значением, метод создает исключение FormatException.
.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки настраиваемого числового формата.
Дополнительные сведения о поддержке форматирования в .NET см. в разделе Типы форматирования.
Формат возвращаемой строки определяется NumberFormatInfo объектом для текущего языка и региональных параметров. В зависимости format
от параметра этот объект управляет такими символами, как отрицательный знак, разделитель групп и символ десятичной запятой в выходной строке. Чтобы предоставить сведения о форматировании для языков и региональных параметров, отличных от текущего, вызовите перегрузку ToString(String, IFormatProvider) .
См. также раздел
- Типы форматирования в .NET
- Практическое руководство. Добавление к числу начальных нулей
- Строки стандартных числовых форматов
- Строки настраиваемых числовых форматов
Применяется к
ToString(String, IFormatProvider)
- Исходный код:
- SByte.cs
- Исходный код:
- SByte.cs
- Исходный код:
- SByte.cs
Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.
public:
virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
public string ToString (string? format, IFormatProvider? provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String
Параметры
- format
- String
Стандартная или пользовательская строка числового формата.
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.
Возвращаемое значение
Строковое представление значения данного экземпляра, определяемое параметрами format
и provider
.
Реализации
Исключения
format
недопустим.
Примеры
В следующем примере отображается как положительное, так и отрицательное SByte значение с помощью описателей стандартного числового формата и ряда конкретных CultureInfo объектов.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"),
CultureInfo.CreateSpecificCulture("fr-FR"),
CultureInfo.CreateSpecificCulture("es-ES") };
sbyte positiveNumber = 119;
sbyte negativeNumber = -45;
string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"};
foreach (string specifier in specifiers)
{
foreach (CultureInfo culture in cultures)
Console.WriteLine("{0,2} 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: 119 -45
// G format using fr-FR culture: 119 -45
// G format using es-ES culture: 119 -45
//
// C format using en-US culture: $119.00 ($45.00)
// C format using fr-FR culture: 119,00 € -45,00 €
// C format using es-ES culture: 119,00 € -45,00 €
//
// D4 format using en-US culture: 0119 -0045
// D4 format using fr-FR culture: 0119 -0045
// D4 format using es-ES culture: 0119 -0045
//
// E2 format using en-US culture: 1.19E+002 -4.50E+001
// E2 format using fr-FR culture: 1,19E+002 -4,50E+001
// E2 format using es-ES culture: 1,19E+002 -4,50E+001
//
// F format using en-US culture: 119.00 -45.00
// F format using fr-FR culture: 119,00 -45,00
// F format using es-ES culture: 119,00 -45,00
//
// N format using en-US culture: 119.00 -45.00
// N format using fr-FR culture: 119,00 -45,00
// N format using es-ES culture: 119,00 -45,00
//
// P format using en-US culture: 11,900.00 % -4,500.00 %
// P format using fr-FR culture: 11 900,00 % -4 500,00 %
// P format using es-ES culture: 11.900,00 % -4.500,00 %
//
// X2 format using en-US culture: 77 D3
// X2 format using fr-FR culture: 77 D3
// X2 format using es-ES culture: 77 D3
open System.Globalization
// Define cultures whose formatting conventions are to be used.
let cultures =
[| CultureInfo.CreateSpecificCulture "en-US"
CultureInfo.CreateSpecificCulture "fr-FR"
CultureInfo.CreateSpecificCulture "es-ES" |]
let positiveNumber = 119y
let negativeNumber = -45y
let specifiers = [| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |]
for specifier in specifiers do
for culture in cultures do
printfn $"{specifier,2} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"
printfn ""
// The example displays the following output:
// G format using en-US culture: 119 -45
// G format using fr-FR culture: 119 -45
// G format using es-ES culture: 119 -45
//
// C format using en-US culture: $119.00 ($45.00)
// C format using fr-FR culture: 119,00 € -45,00 €
// C format using es-ES culture: 119,00 € -45,00 €
//
// D4 format using en-US culture: 0119 -0045
// D4 format using fr-FR culture: 0119 -0045
// D4 format using es-ES culture: 0119 -0045
//
// E2 format using en-US culture: 1.19E+002 -4.50E+001
// E2 format using fr-FR culture: 1,19E+002 -4,50E+001
// E2 format using es-ES culture: 1,19E+002 -4,50E+001
//
// F format using en-US culture: 119.00 -45.00
// F format using fr-FR culture: 119,00 -45,00
// F format using es-ES culture: 119,00 -45,00
//
// N format using en-US culture: 119.00 -45.00
// N format using fr-FR culture: 119,00 -45,00
// N format using es-ES culture: 119,00 -45,00
//
// P format using en-US culture: 11,900.00 % -4,500.00 %
// P format using fr-FR culture: 11 900,00 % -4 500,00 %
// P format using es-ES culture: 11.900,00 % -4.500,00 %
//
// X2 format using en-US culture: 77 D3
// X2 format using fr-FR culture: 77 D3
// X2 format using es-ES culture: 77 D3
Imports System.Globalization
Module Example
Public Sub Main()
' 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 SByte = 119
Dim negativeNumber As SByte = -45
Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}
For Each specifier As String In specifiers
For Each culture As CultureInfo In Cultures
Console.WriteLine("{0,2} format using {1} culture: {2, 16} {3, 16}", _
specifier, culture.Name, _
positiveNumber.ToString(specifier, culture), _
negativeNumber.ToString(specifier, culture))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' G format using en-US culture: 119 -45
' G format using fr-FR culture: 119 -45
' G format using es-ES culture: 119 -45
'
' C format using en-US culture: $119.00 ($45.00)
' C format using fr-FR culture: 119,00 € -45,00 €
' C format using es-ES culture: 119,00 € -45,00 €
'
' D4 format using en-US culture: 0119 -0045
' D4 format using fr-FR culture: 0119 -0045
' D4 format using es-ES culture: 0119 -0045
'
' E2 format using en-US culture: 1.19E+002 -4.50E+001
' E2 format using fr-FR culture: 1,19E+002 -4,50E+001
' E2 format using es-ES culture: 1,19E+002 -4,50E+001
'
' F format using en-US culture: 119.00 -45.00
' F format using fr-FR culture: 119,00 -45,00
' F format using es-ES culture: 119,00 -45,00
'
' N format using en-US culture: 119.00 -45.00
' N format using fr-FR culture: 119,00 -45,00
' N format using es-ES culture: 119,00 -45,00
'
' P format using en-US culture: 11,900.00 % -4,500.00 %
' P format using fr-FR culture: 11 900,00 % -4 500,00 %
' P format using es-ES culture: 11.900,00 % -4.500,00 %
'
' X2 format using en-US culture: 77 D3
' X2 format using fr-FR culture: 77 D3
' X2 format using es-ES culture: 77 D3
Комментарии
Метод ToString(String, IFormatProvider) форматирует SByte значение в указанном формате указанного языка и региональных параметров. Если вы хотите использовать параметры формата или языка и региональных параметров по умолчанию, используйте другие перегрузки ToString метода следующим образом:
Использование формата | Для языка и региональных параметров | Использование перегрузки |
---|---|---|
Формат по умолчанию ("G") | Язык и региональные параметры по умолчанию (текущий) | ToString() |
Формат по умолчанию ("G") | Определенный язык и региональные параметры | ToString(IFormatProvider) |
Определенный формат | Язык и региональные параметры по умолчанию (текущий) | ToString(String) |
Параметром format
может быть любой допустимый описатель стандартного числового формата или любое сочетание описателей настраиваемых числовых форматов. Если format
равно String.Empty или равно null
, возвращаемое значение текущего SByte объекта форматируется с помощью описателя общего формата ("G"). Если format
является любым другим значением, метод создает исключение FormatException.
.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:
Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки настраиваемого числового формата.
Дополнительные сведения о поддержке форматирования в .NET см. в разделе Типы форматирования.
Параметр provider
является реализацией IFormatProvider . Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о формате строки, возвращаемой этим методом, с учетом языка и региональных параметров. При вызове ToString(String, IFormatProvider) метода он вызывает provider
метод параметра IFormatProvider.GetFormat и передает ему Type объект, представляющий NumberFormatInfo тип . Затем GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения для форматирования value
параметра, например символ отрицательного знака, символ разделителя групп или символ десятичной запятой. Существует три способа использования provider
параметра для предоставления сведений о форматировании методу ToString(String, IFormatProvider) :
Можно передать CultureInfo объект , представляющий язык и региональные параметры, предоставляющие сведения о форматировании. Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий числовые сведения о форматировании для этого языка и региональных параметров.
Можно передать фактический NumberFormatInfo объект, предоставляющий числовые сведения о форматировании. (Его реализация GetFormat просто возвращает себя.)
Можно передать пользовательский объект, реализующий IFormatProvider. Его GetFormat метод создает экземпляр и возвращает NumberFormatInfo объект , предоставляющий сведения о форматировании.
Если provider
имеет значение null
, форматирование возвращаемой строки основано на объекте NumberFormatInfo текущего языка и региональных параметров.
См. также раздел
- Типы форматирования в .NET
- Практическое руководство. Добавление к числу начальных нулей
- Строки стандартных числовых форматов
- Строки настраиваемых числовых форматов
- Пример: служебная программа форматирования .NET Core WinForms (C#)
- Пример: служебная программа форматирования .NET Core WinForms (Visual Basic)