BigInteger.ToString BigInteger.ToString BigInteger.ToString BigInteger.ToString Method

Определение

Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление.Converts the numeric value of the current BigInteger object to its equivalent string representation.

Перегрузки

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

Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление.Converts the numeric value of the current BigInteger object to its equivalent string representation.

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

Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление, используя указанные сведения об особенностях форматирования для данного языка и региональных параметров.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting information.

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

Преобразует числовое значение текущего объекта BigInteger в эквивалентное строковое представление с использованием указанного формата.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format.

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

Преобразует значение текущего объекта BigInteger в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях формата для определенного языка и региональных параметров.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format and culture-specific format information.

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

Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление.Converts the numeric value of the current BigInteger object 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

Возвраты

Строковое представление значения текущего объекта BigInteger.The string representation of the current BigInteger value.

Примеры

В следующем примере BigInteger значение отображается с помощью метода по умолчанию ToString() .The following example displays a BigInteger value by using the default ToString() method. Он также отображает строковые представления BigInteger значения, полученные в результате использования некоторых стандартных описателей формата.It also displays the string representations of the BigInteger value that results from using some standard format specifiers. Примеры отображаются с использованием соглашений о форматировании языка и региональных параметров en-US.The examples are displayed using the formatting conventions of the en-US culture.

// 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" или циклический обмен данными с форматом текущего языка и региональных параметров.The ToString() method formats a BigInteger value in the "R", or round-trip, format 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
Формат приема-передачи ("R")Round-trip ("R") format Конкретный язык и региональные параметрыA specific culture ToString
Конкретный форматA specific format Культура по умолчанию (текущий)Default (current) culture ToString(String)
Конкретный форматA specific format Конкретный язык и региональные параметрыA specific culture ToString(String, IFormatProvider)

Строковое представление BigInteger значения содержит отрицательный знак, если его значение отрицательное, и последовательность цифр в диапазоне от 0 до 9 без ведущих нулей.The string representation of the BigInteger value includes a negative sign if its value is negative, and a sequence of digits ranging from 0 to 9 without leading zeros. Отрицательный знак определяется NumberFormatInfo объектом для текущего языка и региональных параметров.The negative sign is defined by the NumberFormatInfo object for the current culture.

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

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

Преобразует числовое значение текущего объекта BigInteger в эквивалентное ему строковое представление, используя указанные сведения об особенностях форматирования для данного языка и региональных параметров.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting information.

public:
 System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Параметры

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

Возвраты

Строковое представление значения текущего объекта BigInteger в формате, заданном параметром provider.The string representation of the current BigInteger value in the format specified by the provider parameter.

Примеры

В следующем примере создается экземпляр пользовательского NumberFormatInfo объекта, который определяет тильду (~) как знак минус.The following example instantiates a custom NumberFormatInfo object that defines the tilde (~) as a negative sign. Затем метод использует пользовательский NumberFormatInfo объект для вывода отрицательного BigInteger значения. ToString(IFormatProvider)The ToString(IFormatProvider) method then uses the custom NumberFormatInfo object to display a negative BigInteger value.

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))

Комментарии

Метод форматирует значение в "R" или "циклический обмен" NumberFormatInfo , используя объект указанной культуры. BigInteger ToString(IFormatProvider)The ToString(IFormatProvider) method formats a BigInteger value in the "R", or round-trip, 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
Формат приема-передачи ("R")Round-trip ("R") format Культура по умолчанию (текущий)Default (current) culture ToString()
Конкретный форматA specific format Культура по умолчанию (текущий)Default (current) culture ToString(String)
Конкретный форматA specific format Конкретный язык и региональные параметрыA specific culture ToString(String, IFormatProvider)

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 returned by this method. Если provider имеет nullзначение, NumberFormatInfo оно форматируется с использованием объекта текущего языка и региональных параметров. BigIntegerIf provider is null, the BigInteger value is formatted using the NumberFormatInfo object of the current culture. Единственным свойством NumberFormatInfo объекта, управляющего строковым представлением BigInteger значения с помощью описателя общего формата, является NumberFormatInfo.NegativeSign, который определяет символ, представляющий знак отрицательного числа.The only property of the NumberFormatInfo object that controls the string representation of the BigInteger value using the general format specifier is NumberFormatInfo.NegativeSign, which defines the character that represents the negative sign.

provider Параметр может быть одним из следующих:The provider parameter can be one of the following:

  • CultureInfo Объект, представляющий язык и региональные параметры, которые предоставляют сведения о форматировании.A CultureInfo object that represents the culture that supplies formatting information.

  • NumberFormatInfo Объект, предоставляющий сведения о форматировании.The NumberFormatInfo object that supplies formatting information.

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

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

Преобразует числовое значение текущего объекта BigInteger в эквивалентное строковое представление с использованием указанного формата.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Параметры

format
String String String String

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

Возвраты

Строковое представление значения текущего объекта BigInteger в формате, заданном параметром format.The string representation of the current BigInteger value in the format specified by the format parameter.

Исключения

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

Примеры

В следующем примере инициализируется BigInteger значение и отображается с помощью каждой строки стандартного формата и некоторых строк настраиваемого формата.The following example initializes a BigInteger value and displays it by using each standard format string and some custom format strings.

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)

Комментарии

Метод форматирует значение вNumberFormatInfo указанном формате с помощью объекта, представляющего соглашения о текущем языке и региональных BigIntegerпараметрах ToString(String) .The ToString(String) method formats a BigInteger value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Если вы хотите использовать "R" или "циклический путь", отформатировать или указать другой язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:If you want to use the "R", or round-trip, format or specify a different culture, use the other overloads of the ToString method, as follows:

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

Параметр может быть любой допустимой стандартной числовой строкойили любым сочетанием строк настраиваемого числового формата. formatThe format parameter can be any valid standard numeric string, or any combination of custom numeric format strings. Если format параметр BigInteger равен или равно, возвращаемое значение текущего объекта форматируется с помощью описателя формата приема-передачи ("R"). null String.EmptyIf format is equal to String.Empty or is null, the return value of the current BigInteger object is formatted with the round-trip format specifier ("R"). Если format параметр имеет любое другое значение, метод FormatExceptionсоздает исключение.If format is any other value, the method throws a FormatException.

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

Формат возвращаемой строки определяется NumberFormatInfo объектом для текущего языка и региональных параметров.The format of the returned string is determined by the NumberFormatInfo object for the current culture. В зависимости format от параметра этот объект управляет такими символами, как знак отрицательного числа, разделитель групп и символ десятичной запятой в выходной строке.Depending on the format parameter, this object controls symbols such as the negative sign, the group separator, and the decimal point symbol in the output string. Чтобы предоставить сведения о форматировании для культур, отличных от текущего языка ToString(String, IFormatProvider) и региональных параметров, вызовите перегрузку.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

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

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

Преобразует значение текущего объекта BigInteger в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях формата для определенного языка и региональных параметров.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Параметры

format
String String String String

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

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

Возвраты

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

Реализации

Исключения

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

Примеры

В следующем примере инициализируется BigInteger значение и отображается в консоли с помощью строки стандартного формата NumberFormatInfo и объекта, определяющего тильду (~) как знак минус.The following example initializes a BigInteger value, and displays it to the console using a standard format string and a NumberFormatInfo object that defines the tilde (~) as a negative sign.

// 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)

Комментарии

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

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

Параметр может быть любой допустимой стандартной числовой строкойили любым сочетанием строк настраиваемого числового формата. formatThe format parameter can be any valid standard numeric string, or any combination of custom numeric format strings. Если format параметр BigInteger равен или равно, возвращаемое значение текущего объекта форматируется с помощью описателя формата приема-передачи ("R"). null String.EmptyIf format is equal to String.Empty or is null, the return value of the current BigInteger object is formatted with the round-trip format specifier ("R"). Если format параметр имеет любое другое значение, метод FormatExceptionсоздает исключение.If format is any other value, the method throws a FormatException.

.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 returned by this method. Type provider GetFormat При вызове метода он вызывает метод параметраNumberFormatInfo и передает ему объект, представляющий тип. ToString(String, IFormatProvider)When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's GetFormat method and passes it a Type object that represents the NumberFormatInfo type. Затем метод возвращает объект, предоставляющий сведения для форматирования value параметра, такие как символ знака минус, символ разделителя группы или символ десятичной запятой. NumberFormatInfo GetFormatThe GetFormat method then returns the NumberFormatInfo object that provides information for formatting the value parameter, such as the negative sign symbol, the group separator symbol, or the decimal point symbol. Существует три способа использования provider параметра для предоставления сведений о ToString(String, IFormatProvider) форматировании методу:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Можно передать CultureInfo объект, представляющий язык и региональные параметры, которые предоставляют сведения о форматировании.You can pass a CultureInfo object that represents the culture that supplies formatting information. Его GetFormat методNumberFormatInfo возвращает объект, предоставляющий сведения о форматировании числовых значений для этого языка и региональных параметров.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Можно передать фактический NumberFormatInfo объект, предоставляющий сведения о форматировании чисел.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Его реализация GetFormat просто возвращает сам себя.)(Its implementation of GetFormat just returns itself.)

  • Можно передать пользовательский объект, реализующий интерфейс IFormatProvider.You can pass a custom object that implements IFormatProvider. Его GetFormat метод создает экземпляр и NumberFormatInfo возвращает объект, предоставляющий сведения о форматировании.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Если provider имеет nullзначение, форматирование возвращаемой NumberFormatInfo строки основано на объекте текущего языка и региональных параметров.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

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

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