BigInteger.ToString Método

Definición

Espacio de nombres:: System.Numerics

Ensamblados:: System.Numerics.dll, System.Runtime.Numerics.dll

Ensamblados:: netstandard.dll, System.Runtime.Numerics.dll

Ensamblado:: System.Runtime.Numerics.dll

Ensamblado:: System.Numerics.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente.

Sobrecargas

Nombre	Description
ToString()	Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente.
ToString(IFormatProvider)	Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente mediante la información de formato específica de la referencia cultural especificada.
ToString(String)	Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente mediante el formato especificado.
ToString(String, IFormatProvider)	Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente mediante el formato especificado y la información de formato específica de la referencia cultural.

ToString()

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente.

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

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Devoluciones

String

Representación de cadena del valor actual BigInteger .

Ejemplos

En el ejemplo siguiente se muestra un BigInteger valor mediante el método predeterminado ToString() . También muestra las representaciones de cadena del BigInteger valor resultantes del uso de algunos especificadores de formato estándar. Los ejemplos se muestran mediante las convenciones de formato de la referencia cultural de 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

Comentarios

El ToString() método da formato a un BigInteger valor en el formato "R" o de ida y vuelta, de la referencia cultural actual. Si desea especificar otro formato o referencia cultural, use las demás sobrecargas del ToString método , como se indica a continuación:

Para usar el formato	Para referencia cultural	Uso de la sobrecarga
Formato de ida y vuelta ("R")	Una referencia cultural específica	ToString
Un formato específico	Referencia cultural predeterminada (actual)	ToString(String)
Un formato específico	Una referencia cultural específica	ToString(String, IFormatProvider)

La representación de cadena del BigInteger valor incluye un signo negativo si su valor es negativo y una secuencia de dígitos comprendido entre 0 y 9 sin ceros iniciales. El signo negativo se define mediante el NumberFormatInfo objeto de la referencia cultural actual.

Consulte también

Se aplica a

ToString(IFormatProvider)

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente mediante la información de formato específica de la referencia cultural especificada.

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

Parámetros

provider: IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

String

Representación de cadena del valor actual BigInteger en el formato especificado por el provider parámetro .

Ejemplos

En el ejemplo siguiente se crea una instancia de un objeto personalizado NumberFormatInfo que define la tilde (~) como un signo negativo. A ToString(IFormatProvider) continuación, el método usa el objeto personalizado NumberFormatInfo para mostrar un valor negativo 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))

Comentarios

El ToString(IFormatProvider) método da formato a un BigInteger valor en el formato "R" o de ida y vuelta mediante el NumberFormatInfo objeto de una referencia cultural especificada. Si desea especificar un formato diferente o la referencia cultural actual, use las demás sobrecargas del ToString método , como se indica a continuación:

Para usar el formato	Para referencia cultural	Uso de la sobrecarga
Formato de ida y vuelta ("R")	Referencia cultural predeterminada (actual)	ToString()
Un formato específico	Referencia cultural predeterminada (actual)	ToString(String)
Un formato específico	Una referencia cultural específica	ToString(String, IFormatProvider)

El provider parámetro es una IFormatProvider implementación. Su GetFormat método devuelve un NumberFormatInfo objeto que proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta por este método. Si provider es null, el BigInteger valor tiene el formato utilizando el NumberFormatInfo objeto de la referencia cultural actual. La única propiedad del NumberFormatInfo objeto que controla la representación de cadena del BigInteger valor mediante el especificador de formato general es NumberFormatInfo.NegativeSign, que define el carácter que representa el signo negativo.

El provider parámetro puede ser uno de los siguientes:

Objeto CultureInfo que representa la referencia cultural que proporciona información de formato.
Objeto NumberFormatInfo que proporciona información de formato.
Objeto personalizado que implementa IFormatProvider. Su GetFormat método devuelve el NumberFormatInfo objeto que proporciona información de formato.

Se aplica a

ToString(String)

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente mediante el formato especificado.

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

Parámetros

format: String

Cadena de formato numérico estándar o personalizado.

Devoluciones

String

Representación de cadena del valor actual BigInteger en el formato especificado por el format parámetro .

Excepciones

FormatException

format no es una cadena de formato válida.

Ejemplos

En el ejemplo siguiente se inicializa un BigInteger valor y se muestra mediante cada cadena de formato estándar y algunas cadenas de formato personalizado.

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)

Comentarios

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

Para usar el formato	Para referencia cultural	Uso de la sobrecarga
Formato de ida y vuelta ("R")	Referencia cultural predeterminada (actual)	ToString()
Formato de ida y vuelta ("R")	Una referencia cultural específica	ToString(IFormatProvider)
Un formato específico	Una referencia cultural específica	ToString(String, IFormatProvider)

El format parámetro puede ser cualquier cadena numérica estándar válida o cualquier combinación de cadenas de formato numérico personalizado. Si format es igual a String.Empty o es null, el valor devuelto del objeto actual BigInteger tiene el formato especificador de formato de ida y vuelta ("R"). Si format es cualquier otro valor, el método produce una FormatExceptionexcepción .

.NET proporciona compatibilidad amplia con formato, que se describe con más detalle en los temas de formato siguientes:

Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre la compatibilidad con el formato en .NET, vea Tipos de formato.

El formato de la cadena devuelta viene determinado por el NumberFormatInfo objeto de la referencia cultural actual. Dependiendo del format parámetro , este objeto controla símbolos como el signo negativo, el separador de grupo y el símbolo decimal de la cadena de salida. Para proporcionar información de formato para referencias culturales distintas de la referencia cultural actual, llame a la ToString(String, IFormatProvider) sobrecarga.

Consulte también

Se aplica a

ToString(String, IFormatProvider)

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Source:: BigInteger.cs

Convierte el valor numérico del objeto actual BigInteger en su representación de cadena equivalente mediante el formato especificado y la información de formato específica de la referencia cultural.

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

Parámetros

format: String

Cadena de formato numérico estándar o personalizado.

provider: IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

String

Representación de cadena del valor actual BigInteger tal y como especifican los format parámetros y provider .

Implementaciones

ToString(String, IFormatProvider)

Excepciones

FormatException

format no es una cadena de formato válida.

Ejemplos

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

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

Comentarios

El ToString(String, IFormatProvider) método da formato a un BigInteger valor en un formato especificado mediante el NumberFormatInfo objeto de una referencia cultural especificada. Si desea usar el formato de ida y vuelta o la configuración de referencia cultural predeterminada, use las demás sobrecargas del ToString método , como se indica a continuación:

Para usar el formato	Para referencia cultural	Uso de la sobrecarga
Formato de ida y vuelta ("R")	Referencia cultural predeterminada (actual)	ToString()
Formato de ida y vuelta ("R")	Una referencia cultural específica	ToString(IFormatProvider)
Un formato específico	Referencia cultural predeterminada (actual)	ToString(String)

.NET proporciona compatibilidad amplia con formato, que se describe con más detalle en los temas de formato siguientes:

Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre la compatibilidad con el formato en .NET, vea Tipos de formato.

El provider parámetro es una IFormatProvider implementación. Su GetFormat método devuelve un NumberFormatInfo objeto que proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta por este método. Cuando se invoca el ToString(String, IFormatProvider) método , llama al provider método del GetFormat parámetro y lo pasa un Type objeto que representa el NumberFormatInfo tipo. A GetFormat continuación, el método devuelve el NumberFormatInfo objeto que proporciona información para dar formato al value parámetro, como el símbolo de signo negativo, el símbolo separador de grupo o el símbolo decimal. Hay tres maneras de usar el provider parámetro para proporcionar información de formato al ToString(String, IFormatProvider) método :

Puede pasar un CultureInfo objeto que represente la referencia cultural que proporciona información de formato. Su GetFormat método devuelve el NumberFormatInfo objeto que proporciona información de formato numérico para esa referencia cultural.
Puede pasar el objeto real NumberFormatInfo que proporciona información de formato numérico. (Su implementación de GetFormat solo devuelve a sí misma).
Puede pasar un objeto personalizado que implemente IFormatProvider. Su GetFormat método crea una instancia y devuelve el NumberFormatInfo objeto que proporciona información de formato.

Si provider es null, el formato de la cadena devuelta se basa en el NumberFormatInfo objeto de la referencia cultural actual.

Consulte también

Se aplica a

Retroalimentació

Ha estat útil aquesta pàgina?

Comparteix via

BigInteger.ToString Método

Definición

Sobrecargas

ToString()

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

ToString(IFormatProvider)

Parámetros

Devoluciones

Ejemplos

Comentarios

Se aplica a

ToString(String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

ToString(String, IFormatProvider)

Parámetros

Devoluciones

Implementaciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Retroalimentació