BigInteger.ToString Método

Definición

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente.Converts the numeric value of the current BigInteger object to its equivalent string representation.

Sobrecargas

ToString()

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente.Converts the numeric value of the current BigInteger object to its equivalent string representation.

ToString(IFormatProvider)

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente usando la información de formato específica de la referencia cultural indicada.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified culture-specific formatting information.

ToString(String)

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente con el formato especificado.Converts the numeric value of the current BigInteger object to its equivalent string representation by using the specified format.

ToString(String, IFormatProvider)

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente usando el formato especificado y la información de formato específica de la referencia cultural.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()

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente.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

Devoluciones

Representación de cadena del valor BigInteger actual.The string representation of the current BigInteger value.

Ejemplos

En el ejemplo siguiente se muestra un valor BigInteger mediante el método ToString() predeterminado.The following example displays a BigInteger value by using the default ToString() method. También se muestran las representaciones de cadena del valor BigInteger que se obtiene al usar algunos especificadores de formato estándar.It also displays the string representations of the BigInteger value that results from using some standard format specifiers. Los ejemplos se muestran mediante las convenciones de formato de la referencia cultural 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      

Comentarios

El método ToString() da formato a un valor BigInteger en el formato "R", o de ida y vuelta, de la referencia cultural actual.The ToString() method formats a BigInteger value in the "R", or round-trip, format of the current culture. Si desea especificar un formato o una referencia cultural diferente, use las otras sobrecargas del método ToString, como se indica a continuación:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Usar la sobrecargaUse the overload
Formato de operación de ida y vuelta ("R")Round-trip ("R") format Una referencia cultural específicaA specific culture ToString
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

La representación de cadena del valor BigInteger incluye un signo negativo si su valor es negativo y una secuencia de dígitos que oscilan entre 0 y 9 sin ceros a la izquierda.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. El signo negativo se define mediante el NumberFormatInfo objeto para la referencia cultural actual.The negative sign is defined by the NumberFormatInfo object for the current culture.

Consulte también:

ToString(IFormatProvider)

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente usando la información de formato específica de la referencia cultural indicada.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

Parámetros

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.An object that supplies culture-specific formatting information.

Devoluciones

Representación de cadena del valor BigInteger actual en el formato especificado por el parámetro provider.The string representation of the current BigInteger value in the format specified by the provider parameter.

Ejemplos

En el ejemplo siguiente se crea una instancia de un objeto de NumberFormatInfo personalizado que define la tilde (~) como signo negativo.The following example instantiates a custom NumberFormatInfo object that defines the tilde (~) as a negative sign. A continuación, el método ToString(IFormatProvider) utiliza el objeto de NumberFormatInfo personalizado para mostrar un valor de BigInteger negativo.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))

Comentarios

El método ToString(IFormatProvider) da formato a un valor BigInteger en el formato "R", o de ida y vuelta, utilizando el objeto NumberFormatInfo de una referencia cultural especificada.The ToString(IFormatProvider) method formats a BigInteger value in the "R", or round-trip, format by using the NumberFormatInfo object of a specified culture. Si desea especificar un formato diferente o la referencia cultural actual, use las otras sobrecargas del método ToString, como se indica a continuación:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Usar la sobrecargaUse the overload
Formato de operación de ida y vuelta ("R")Round-trip ("R") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

El parámetro provider es una implementación de IFormatProvider.The provider parameter is an IFormatProvider implementation. Su método GetFormat devuelve un objeto NumberFormatInfo que proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta por este método.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Si provider se null, se da formato al valor de BigInteger utilizando el objeto NumberFormatInfo de la referencia cultural actual.If provider is null, the BigInteger value is formatted using the NumberFormatInfo object of the current culture. La única propiedad del objeto NumberFormatInfo que controla la representación de cadena del valor BigInteger mediante el especificador de formato general es NumberFormatInfo.NegativeSign, que define el carácter que representa el signo negativo.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.

El parámetro provider puede ser uno de los siguientes:The provider parameter can be one of the following:

ToString(String)

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente con el formato especificado.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

Parámetros

format
String

Cadena de formato numérico estándar o personalizada.A standard or custom numeric format string.

Devoluciones

Representación de cadena del valor BigInteger actual en el formato especificado por el parámetro format.The string representation of the current BigInteger value in the format specified by the format parameter.

Excepciones

format no es una cadena de formato válido.format is not a valid format string.

Ejemplos

En el ejemplo siguiente se inicializa un valor BigInteger y se muestra mediante cada cadena de formato estándar y algunas cadenas de formato personalizado.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)

Comentarios

El método ToString(String) da formato a un valor BigInteger en un formato especificado mediante el uso de un objeto NumberFormatInfo que representa las convenciones de la referencia cultural actual.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. Si desea usar el formato "R", o de ida y vuelta, o especifica una referencia cultural diferente, use las otras sobrecargas del método ToString, como se indica a continuación: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:

Para usar el formatoTo use format Para la referencia culturalFor culture Usar la sobrecargaUse the overload
Formato de operación de ida y vuelta ("R")Round-trip ("R") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Formato de operación de ida y vuelta ("R")Round-trip ("R") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

El parámetro format puede ser cualquier cadena numérica estándarválida o cualquier combinación de cadenas de formato numérico personalizado.The format parameter can be any valid standard numeric string, or any combination of custom numeric format strings. Si format es igual a String.Empty o es null, se da formato al valor devuelto del objeto BigInteger actual con el especificador de formato de ida y vuelta ("R").If 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"). Si format es cualquier otro valor, el método produce una FormatException.If format is any other value, the method throws a FormatException.

El .NET Framework proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

El formato de la cadena devuelta viene determinado por el objeto NumberFormatInfo de la referencia cultural actual.The format of the returned string is determined by the NumberFormatInfo object for the current culture. Dependiendo del parámetro format, este objeto controla símbolos como el signo negativo, el separador de grupos y el símbolo de separador decimal en la cadena de salida.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. Para proporcionar información de formato para las referencias culturales distintas de la referencia cultural actual, llame a la sobrecarga ToString(String, IFormatProvider).To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Consulte también:

ToString(String, IFormatProvider)

Convierte el valor numérico del objeto BigInteger actual en su representación de cadena equivalente usando el formato especificado y la información de formato específica de la referencia cultural.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

Parámetros

format
String

Cadena de formato numérico estándar o personalizada.A standard or custom numeric format string.

provider
IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.An object that supplies culture-specific formatting information.

Devoluciones

Representación de cadena del valor BigInteger actual, tal como la especifican los parámetros format y provider.The string representation of the current BigInteger value as specified by the format and provider parameters.

Implementaciones

Excepciones

format no es una cadena de formato válido.format is not a valid format string.

Ejemplos

En el ejemplo siguiente se inicializa un valor BigInteger y se muestra en la consola mediante una cadena de formato estándar y un objeto NumberFormatInfo que define la tilde (~) como signo negativo.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)

Comentarios

El método ToString(String, IFormatProvider) da formato a un valor BigInteger en un formato especificado mediante el objeto NumberFormatInfo de una referencia cultural especificada.The ToString(String, IFormatProvider) method formats a BigInteger value in a specified format by using the NumberFormatInfo object of a specified culture. Si desea utilizar la configuración de la referencia cultural predeterminada o el formato de ida y vuelta, utilice las otras sobrecargas del método ToString, como se indica a continuación:If you want to use the round-trip format or default culture settings, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Usar la sobrecargaUse the overload
Formato de operación de ida y vuelta ("R")Round-trip ("R") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Formato de operación de ida y vuelta ("R")Round-trip ("R") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)

El parámetro format puede ser cualquier cadena numérica estándarválida o cualquier combinación de cadenas de formato numérico personalizado.The format parameter can be any valid standard numeric string, or any combination of custom numeric format strings. Si format es igual a String.Empty o es null, se da formato al valor devuelto del objeto BigInteger actual con el especificador de formato de ida y vuelta ("R").If 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"). Si format es cualquier otro valor, el método produce una FormatException.If format is any other value, the method throws a FormatException.

El .NET Framework proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

El parámetro provider es una implementación de IFormatProvider.The provider parameter is an IFormatProvider implementation. Su método GetFormat devuelve un objeto NumberFormatInfo que proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta por este método.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Cuando se invoca el método de ToString(String, IFormatProvider), llama al método GetFormat del parámetro provider y le pasa un objeto Type que representa el tipo NumberFormatInfo.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. A continuación, el método GetFormat devuelve el NumberFormatInfo objeto que proporciona información para dar formato al parámetro de value, como el símbolo de signo negativo, el símbolo de separador de grupo o el símbolo de separador decimal.The 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. Hay tres maneras de usar el parámetro provider para proporcionar información de formato al método ToString(String, IFormatProvider):There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Puede pasar un objeto CultureInfo que represente la referencia cultural que proporciona información de formato.You can pass a CultureInfo object that represents the culture that supplies formatting information. Su método GetFormat devuelve el objeto NumberFormatInfo que proporciona información de formato numérico para esa referencia cultural.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Puede pasar el objeto de NumberFormatInfo real que proporciona información de formato numérico.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Su implementación de GetFormat simplemente se devuelve).(Its implementation of GetFormat just returns itself.)

  • Puede pasar un objeto personalizado que implementa IFormatProvider.You can pass a custom object that implements IFormatProvider. Su método GetFormat crea una instancia de y devuelve el objeto NumberFormatInfo que proporciona información de formato.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Si se null``provider, el formato de la cadena devuelta se basa en el objeto NumberFormatInfo de la referencia cultural actual.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Consulte también:

Se aplica a