BigInteger.ToString Метод

Ссылка

Определение

Пространство имен:: System.Numerics

Сборка:: System.Runtime.Numerics.dll

Сборка:: System.Numerics.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление.

Перегрузки

ToString(String, IFormatProvider)	Преобразует значение текущего объекта BigInteger в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях формата для определенного языка и региональных параметров.
ToString(String)	Преобразует числовое значение текущего объекта BigInteger в эквивалентное строковое представление с использованием указанного формата.
ToString(IFormatProvider)	Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление, используя указанные сведения об особенностях форматирования для данного языка и региональных параметров.
ToString()	Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление.

ToString(String, IFormatProvider)

Преобразует значение текущего объекта BigInteger в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях формата для определенного языка и региональных параметров.

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

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.

Возвращаемое значение

String

Строковое представление текущего значения BigInteger в виде, заданном параметрами format и provider.

Реализации

ToString(String, IFormatProvider)

Исключения

FormatException

format не является допустимым форматом строки.

Примеры

В следующем примере значение инициализируется BigInteger и отображается в консоли с помощью строки стандартного формата и NumberFormatInfo объекта, определяющего тильду (~) как знак отрицательного.

// Redefine the negative sign as the tilde for the invariant culture.
NumberFormatInfo bigIntegerFormatter = new NumberFormatInfo();
bigIntegerFormatter.NegativeSign = "~";

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0",
                        "G", "N0", "P", "R", "X", "0,0.000",
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier,
                     bigIntegerFormatter));

// The example displays the following output:
//    C: (☼903,145,792,771,643,190,182.00)
//    D: ~903145792771643190182
//    D25: ~0000903145792771643190182
//    E: ~9.031457E+020
//    E4: ~9.0314E+020
//    e8: ~9.03145792e+020
//    F0: ~903145792771643190182
//    G: ~903145792771643190182
//    N0: ~903,145,792,771,643,190,182
//    P: ~90,314,579,277,164,319,018,200.00 %
//    R: ~903145792771643190182
//    X: CF0A55968BB1A7545A
//    0,0.000: ~903,145,792,771,643,190,182.000
//    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

' Redefine the negative sign as the tilde for the invariant culture.
Dim bigIntegerFormatter As New NumberFormatInfo()
bigIntegerFormatter.NegativeSign = "~"

Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier, 
                     bigIntegerformatter))
Next   
' The example displays the following output:
'    C: (☼903,145,792,771,643,190,182.00)
'    D: ~903145792771643190182
'    D25: ~0000903145792771643190182
'    E: ~9.031457E+020
'    E4: ~9.0314E+020
'    e8: ~9.03145792e+020
'    F0: ~903145792771643190182
'    G: ~903145792771643190182
'    N0: ~903,145,792,771,643,190,182
'    P: ~90,314,579,277,164,319,018,200.00 %
'    R: ~903145792771643190182
'    X: CF0A55968BB1A7545A
'    0,0.000: ~903,145,792,771,643,190,182.000
'    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Метод ToString(String, IFormatProvider) форматирует BigInteger значение в указанном формате с помощью NumberFormatInfo объекта указанного языка и региональных параметров. Если вы хотите использовать формат кругового пути или параметры языка и региональных параметров по умолчанию, используйте другие перегрузки ToString метода следующим образом:

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат кругового пути ("R")	Язык и региональные параметры по умолчанию (текущий)	ToString()
Формат кругового пути ("R")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Язык и региональные параметры по умолчанию (текущий)	ToString(String)

Параметр format может быть любой допустимой стандартной числовой строкой или любым сочетанием строк пользовательского числового формата. Если format значение равно String.Empty или равно null, возвращаемое значение текущего BigInteger объекта форматируется с помощью описатель формата кругового пути ("R"). Если format является любым другим значением, метод создает исключение FormatException.

.NET предоставляет обширную поддержку форматирования, которая более подробно описана в следующих разделах форматирования:

Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки пользовательского числового формата.
Дополнительные сведения о поддержке форматирования в .NET см. в разделе Типы форматирования.

Параметр provider является реализацией IFormatProvider . Его GetFormat метод возвращает объект , предоставляющий NumberFormatInfo сведения о формате строки, возвращаемой этим методом, с учетом языка и региональных параметров. При вызове ToString(String, IFormatProvider) метода он вызывает provider метод параметра GetFormat и передает ему Type объект, представляющий NumberFormatInfo тип . GetFormat Затем метод возвращает NumberFormatInfo объект , который предоставляет сведения для форматирования value параметра, такие как символ отрицательного знака, символ разделителя групп или символ десятичной запятой. Существует три способа использования provider параметра для предоставления сведений о форматировании методу ToString(String, IFormatProvider) :

Вы можете передать CultureInfo объект , представляющий язык и региональные параметры, предоставляющие сведения о форматировании. Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий числовые сведения о форматировании для этого языка и региональных параметров.
Вы можете передать фактический NumberFormatInfo объект, предоставляющий числовые сведения о форматировании. (Его реализация GetFormat просто возвращает себя.)
Можно передать пользовательский объект, реализующий IFormatProvider. Его GetFormat метод создает экземпляр и возвращает NumberFormatInfo объект , предоставляющий сведения о форматировании.

Если provider имеет значение null, форматирование возвращаемой строки основано на объекте NumberFormatInfo текущего языка и региональных параметров.

См. также раздел

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

ToString(String)

Преобразует числовое значение текущего объекта BigInteger в эквивалентное строковое представление с использованием указанного формата.

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

Стандартная или пользовательская строка числового формата.

Возвращаемое значение

String

Строковое представление значения текущего объекта BigInteger в формате, заданном параметром format.

Исключения

FormatException

format не является допустимым форматом строки.

Примеры

В следующем примере инициализируется BigInteger значение и отображается с использованием каждой строки стандартного формата и некоторых строк настраиваемого формата.

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0",
                        "G", "N0", "P", "R", "X", "0,0.000",
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));

// The example displays the following output:
//       C: ($903,145,792,771,643,190,182.00)
//       D: -903145792771643190182
//       D25: -0000903145792771643190182
//       E: -9.031457E+020
//       E4: -9.0314E+020
//       e8: -9.03145792e+020
//       F0: -903145792771643190182
//       G: -903145792771643190182
//       N0: -903,145,792,771,643,190,182
//       P: -90,314,579,277,164,319,018,200.00 %
//       R: -903145792771643190182
//       X: CF0A55968BB1A7545A
//       0,0.000: -903,145,792,771,643,190,182.000
//       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next   
' The example displays the following output:
'       C: ($903,145,792,771,643,190,182.00)
'       D: -903145792771643190182
'       D25: -0000903145792771643190182
'       E: -9.031457E+020
'       E4: -9.0314E+020
'       e8: -9.03145792e+020
'       F0: -903145792771643190182
'       G: -903145792771643190182
'       N0: -903,145,792,771,643,190,182
'       P: -90,314,579,277,164,319,018,200.00 %
'       R: -903145792771643190182
'       X: CF0A55968BB1A7545A
'       0,0.000: -903,145,792,771,643,190,182.000
'       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Метод ToString(String) форматирует BigInteger значение в указанном формате с помощью NumberFormatInfo объекта , представляющего соглашения текущего языка и региональных параметров. Если вы хотите использовать "R" или циклический цикл, отформатировать или указать другой язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат кругового пути ("R")	Язык и региональные параметры по умолчанию (текущий)	ToString()
Формат кругового пути ("R")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки пользовательского числового формата.
Дополнительные сведения о поддержке форматирования в .NET см. в разделе Типы форматирования.

Формат возвращаемой строки определяется NumberFormatInfo объектом для текущего языка и региональных параметров. В зависимости format от параметра этот объект управляет такими символами, как знак "минус", разделитель групп и символ десятичной запятой в выходной строке. Чтобы предоставить сведения о форматировании для языков и региональных параметров, отличных от текущего языка и региональных параметров, вызовите перегрузку ToString(String, IFormatProvider) .

См. также раздел

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

ToString(IFormatProvider)

Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление, используя указанные сведения об особенностях форматирования для данного языка и региональных параметров.

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

Объект, предоставляющий сведения о форматировании для определенного языка и региональных параметров.

Возвращаемое значение

String

Строковое представление значения текущего объекта BigInteger в формате, заданном параметром provider.

Примеры

В следующем примере создается экземпляр пользовательского NumberFormatInfo объекта, который определяет тильду (~) как отрицательный знак. Затем ToString(IFormatProvider) метод использует пользовательский NumberFormatInfo объект для отображения отрицательного BigInteger значения.

BigInteger number = 9867857831128;
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne;

NumberFormatInfo bigIntegerProvider = new NumberFormatInfo();
bigIntegerProvider.NegativeSign = "~";

Console.WriteLine(number.ToString(bigIntegerProvider));

Dim number As BigInteger = 9867857831128
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

Dim bigIntegerProvider As New NumberFormatInfo()
bigIntegerProvider.NegativeSign = "~"      

Console.WriteLine(number.ToString(bigIntegerProvider))

Метод ToString(IFormatProvider) форматирует BigInteger значение в формате "R" или круговой путь, используя NumberFormatInfo объект указанного языка и региональных параметров. Если вы хотите указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат кругового пути ("R")	Язык и региональные параметры по умолчанию (текущий)	ToString()
Определенный формат	Язык и региональные параметры по умолчанию (текущий)	ToString(String)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

Параметр provider является реализацией IFormatProvider . Его GetFormat метод возвращает объект , предоставляющий NumberFormatInfo сведения о формате строки, возвращаемой этим методом, с учетом языка и региональных параметров. Если provider имеет значение null, BigInteger значение форматируется с использованием NumberFormatInfo объекта текущего языка и региональных параметров. Единственным свойством NumberFormatInfo объекта, который управляет строковым представлением BigInteger значения с помощью описателя общего формата, является NumberFormatInfo.NegativeSign, который определяет символ, представляющий знак "минус".

Параметр provider может иметь один из следующих значений:

Объект CultureInfo , представляющий язык и региональные параметры, предоставляющие сведения о форматировании.
Объект NumberFormatInfo , предоставляющий сведения о форматировании.
Пользовательский объект, реализующий IFormatProvider. Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о форматировании.

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

ToString()

Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Возвращаемое значение

String

Строковое представление значения текущего объекта BigInteger.

Примеры

В следующем примере отображается BigInteger значение с помощью метода по умолчанию ToString() . В нем также отображаются строковые представления значения, полученного BigInteger при использовании некоторых описателей стандартного формата. Примеры отображаются с использованием соглашений о форматировании языка и региональных параметров en-US.

// Initialize a BigInteger value.
BigInteger value = BigInteger.Add(UInt64.MaxValue, 1024);

// Display value using the 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 on a system whose current
// culture is en-US:
//       18446744073709552639
//       18446744073709552639
//       $18,446,744,073,709,552,639.00
//       18446744073709552639
//       18446744073709552639.00
//       18,446,744,073,709,552,639.00
//       100000000000003FF

' Initialize a BigInteger value.
Dim value As BigInteger = BigInteger.Add(UInt64.MaxValue, 1024)

' Display value using the 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 on a system whose current 
' culture is en-US:
'       18446744073709552639
'       18446744073709552639
'       $18,446,744,073,709,552,639.00
'       18446744073709552639
'       18446744073709552639.00
'       18,446,744,073,709,552,639.00
'       100000000000003FF

Метод ToString() форматирует BigInteger значение в формате "R" или круговой путь текущего языка и региональных параметров. Если вы хотите указать другой формат или язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат кругового пути ("R")	Определенный язык и региональные параметры	ToString
Определенный формат	Язык и региональные параметры по умолчанию (текущий)	ToString(String)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

Строковое представление BigInteger значения включает отрицательный знак, если его значение отрицательное, и последовательность цифр в диапазоне от 0 до 9 без начальных нулей. Отрицательный знак определяется NumberFormatInfo объектом для текущего языка и региональных параметров.

См. также раздел

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

BigInteger.ToString Метод

Определение

Перегрузки

ToString(String, IFormatProvider)

Параметры

Возвращаемое значение

Реализации

Исключения

Примеры

Комментарии

См. также раздел

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

ToString(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

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

ToString(IFormatProvider)

Параметры

Возвращаемое значение

Примеры

Комментарии

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

ToString()

Возвращаемое значение

Примеры

Комментарии

См. также раздел

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

Обратная связь

Дополнительные ресурсы