BigInteger.ToString Метод

Определение

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

Сборки:: System.Numerics.dll, System.Runtime.Numerics.dll

Сборки:: netstandard.dll, System.Runtime.Numerics.dll

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

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

Сборка:: netstandard.dll

Важно!

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

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

Перегрузки

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

ToString()

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Преобразует числовое значение текущего 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.
    let value = BigInteger.Add(UInt64.MaxValue, 1024)

    // Display value using the default ToString method.
    printfn $"{value.ToString()}"
    // Display value using some standard format specifiers.
    printfn $"""{value.ToString("G")}"""
    printfn $"""{value.ToString("C")}"""
    printfn $"""{value.ToString("D")}"""
    printfn $"""{value.ToString("F")}"""
    printfn $"""{value.ToString("N")}"""
    printfn $"""{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
Определенный формат	Язык и региональные параметры по умолчанию (current)	ToString(String)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

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

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

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

ToString(IFormatProvider)

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Преобразует числовое значение текущего 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));

let number = bigint 9867857831128L
let number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

let bigIntegerProvider = NumberFormatInfo()
bigIntegerProvider.NegativeSign <- "~"

printfn $"{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")	Язык и региональные параметры по умолчанию (current)	ToString()
Определенный формат	Язык и региональные параметры по умолчанию (current)	ToString(String)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

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

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

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

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

ToString(String)

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Преобразует числовое значение текущего 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)

    // Define a BigInteger value.
    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{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")	Язык и региональные параметры по умолчанию (current)	ToString()
Формат кругового пути ("R")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

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

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

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

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

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

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

ToString(String, IFormatProvider)

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Исходный код:: BigInteger.cs

Преобразует числовое значение текущего 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.
    let bigIntegerFormatter = NumberFormatInfo()
    bigIntegerFormatter.NegativeSign <- "~"

    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{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")	Язык и региональные параметры по умолчанию (current)	ToString()
Формат кругового пути ("R")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Язык и региональные параметры по умолчанию (current)	ToString(String)

Дополнительные сведения об описателях числовых форматов см. в разделе "Стандартные числовые строки" и "Настраиваемые числовые строки".
Дополнительные сведения о поддержке форматирования в .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 объекте текущего языка и региональных параметров.

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

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

Кері байланыс

Бет пайдалы болды ма?

Бөлісу құралы:

BigInteger.ToString Метод

Определение

Перегрузки

ToString()

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

Примеры

Комментарии

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

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

ToString(IFormatProvider)

Параметры

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

Примеры

Комментарии

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

ToString(String)

Параметры

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

Исключения

Примеры

Комментарии

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

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

ToString(String, IFormatProvider)

Параметры

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

Реализации

Исключения

Примеры

Комментарии

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

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