BigInteger.ToString Método

Referência

Definição

Namespace:: System.Numerics

Assembly:: System.Runtime.Numerics.dll

Assembly:: System.Numerics.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente.

Sobrecargas

ToString(String, IFormatProvider)	Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.
ToString(String)	Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente usando o formato especificado.
ToString(IFormatProvider)	Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.
ToString()	Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente.

ToString(String, IFormatProvider)

Origem:: BigInteger.cs

Origem:: BigInteger.cs

Origem:: BigInteger.cs

Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.

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

Uma cadeia de caracteres de formato numérico padrão ou personalizado.

provider: IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura.

Retornos

String

A representação da cadeia de caracteres do valor BigInteger atual, conforme especificado pelos parâmetros format e provider.

Implementações

ToString(String, IFormatProvider)

Exceções

FormatException

format não é uma cadeia de caracteres de formato válida.

Exemplos

O exemplo a seguir inicializa um valor BigInteger e o exibe no console usando uma cadeia de caracteres de formato padrão e um objeto NumberFormatInfo que define o bloco (~) como um sinal 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)

Comentários

O método ToString(String, IFormatProvider) formata um valor BigInteger em um formato especificado usando o objeto NumberFormatInfo de uma cultura especificada. Se você quiser usar o formato de viagem de ida e volta ou as configurações de cultura padrão, use as outras sobrecargas do método ToString da seguinte maneira:

Para usar o formato	Para cultura	Usar a sobrecarga
Formato de ida e volta ("R")	Cultura padrão (atual)	ToString()
Formato de ida e volta ("R")	Uma cultura específica	ToString(IFormatProvider)
Um formato específico	Cultura padrão (atual)	ToString(String)

O parâmetro pode ser qualquerde cadeia de caracteres numérica padrão válida ou qualquer combinação de cadeias de caracteres de formato numérico personalizado. Se format for igual a String.Empty ou for null, o valor retornado do objeto BigInteger atual será formatado com o especificador de formato de viagem de ida e volta ("R"). Se format for qualquer outro valor, o método gerará um FormatException.

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:

Para obter mais informações sobre especificadores de formato numérico, consulte cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre o suporte à formatação no .NET, consulte Tipos de Formatação.

O parâmetro provider é uma implementação IFormatProvider. Seu método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas da cultura sobre o formato da cadeia de caracteres retornada por esse método. Quando o método ToString(String, IFormatProvider) é invocado, ele chama o método GetFormat do parâmetro provider e passa um objeto Type que representa o tipo NumberFormatInfo. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações para formatar o parâmetro value, como o símbolo de sinal negativo, o símbolo separador de grupo ou o símbolo de ponto decimal. Há três maneiras de usar o parâmetro provider para fornecer informações de formatação ao método ToString(String, IFormatProvider):

Você pode passar um objeto CultureInfo que representa a cultura que fornece informações de formatação. Seu método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação numérica para essa cultura.
Você pode passar o objeto NumberFormatInfo real que fornece informações de formatação numérica. (Sua implementação de GetFormat apenas retorna a si mesma.)
Você pode passar um objeto personalizado que implementa IFormatProvider. Seu método GetFormat cria uma instância e retorna o objeto NumberFormatInfo que fornece informações de formatação.

Se provider for null, a formatação da cadeia de caracteres retornada será baseada no objeto NumberFormatInfo da cultura atual.

Confira também

cadeias de caracteres de formato numérico padrão
cadeias de caracteres de formato numérico personalizado

Aplica-se a

ToString(String)

Origem:: BigInteger.cs

Origem:: BigInteger.cs

Origem:: BigInteger.cs

Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente usando o 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

Uma cadeia de caracteres de formato numérico padrão ou personalizado.

Retornos

String

A representação da cadeia de caracteres do valor BigInteger atual no formato especificado pelo parâmetro format.

Exceções

FormatException

format não é uma cadeia de caracteres de formato válida.

Exemplos

O exemplo a seguir inicializa um valor BigInteger e o exibe usando cada cadeia de caracteres de formato padrão e algumas cadeias de caracteres 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)

Comentários

O método ToString(String) formata um valor BigInteger em um formato especificado usando um objeto NumberFormatInfo que representa as convenções da cultura atual. Se você quiser usar "R", ou ida e volta, formatar ou especificar uma cultura diferente, use as outras sobrecargas do método ToString, da seguinte maneira:

Para usar o formato	Para cultura	Usar a sobrecarga
Formato de ida e volta ("R")	Cultura padrão (atual)	ToString()
Formato de ida e volta ("R")	Uma cultura específica	ToString(IFormatProvider)
Um formato específico	Uma cultura específica	ToString(String, IFormatProvider)

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:

Para obter mais informações sobre especificadores de formato numérico, consulte cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre o suporte à formatação no .NET, consulte Tipos de Formatação.

O formato da cadeia de caracteres retornada é determinado pelo objeto NumberFormatInfo para a cultura atual. Dependendo do parâmetro format, esse objeto controla símbolos como o sinal negativo, o separador de grupo e o símbolo de ponto decimal na cadeia de caracteres de saída. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame a sobrecarga de ToString(String, IFormatProvider).

Confira também

cadeias de caracteres de formato numérico padrão
cadeias de caracteres de formato numérico personalizado

Aplica-se a

ToString(IFormatProvider)

Origem:: BigInteger.cs

Origem:: BigInteger.cs

Origem:: BigInteger.cs

Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.

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

Um objeto que fornece informações de formatação específicas da cultura.

Retornos

String

A representação da cadeia de caracteres do valor BigInteger atual no formato especificado pelo parâmetro provider.

Exemplos

O exemplo a seguir cria uma instância de um objeto de NumberFormatInfo personalizado que define o bloco (~) como um sinal negativo. O método ToString(IFormatProvider) usa o objeto NumberFormatInfo personalizado para exibir um valor de BigInteger negativo.

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

Comentários

O método ToString(IFormatProvider) formata um valor BigInteger no formato "R", ou ida e volta, usando o objeto NumberFormatInfo de uma cultura especificada. Se você quiser especificar um formato diferente ou a cultura atual, use as outras sobrecargas do método ToString, da seguinte maneira:

Para usar o formato	Para cultura	Usar a sobrecarga
Formato de ida e volta ("R")	Cultura padrão (atual)	ToString()
Um formato específico	Cultura padrão (atual)	ToString(String)
Um formato específico	Uma cultura específica	ToString(String, IFormatProvider)

O parâmetro provider é uma implementação IFormatProvider. Seu método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas da cultura sobre o formato da cadeia de caracteres retornada por esse método. Se provider for null, o valor BigInteger será formatado usando o objeto NumberFormatInfo da cultura atual. A única propriedade do objeto NumberFormatInfo que controla a representação de cadeia de caracteres do valor BigInteger usando o especificador de formato geral é NumberFormatInfo.NegativeSign, que define o caractere que representa o sinal negativo.

O parâmetro provider pode ser um dos seguintes:

Um objeto CultureInfo que representa a cultura que fornece informações de formatação.
O objeto NumberFormatInfo que fornece informações de formatação.
Um objeto personalizado que implementa IFormatProvider. Seu método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação.

Aplica-se a

ToString()

Origem:: BigInteger.cs

Origem:: BigInteger.cs

Origem:: BigInteger.cs

Converte o valor numérico do objeto BigInteger atual em sua representação de cadeia de caracteres equivalente.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retornos

String

A representação da cadeia de caracteres do valor BigInteger atual.

Exemplos

O exemplo a seguir exibe um valor BigInteger usando o método de ToString() padrão. Ele também exibe as representações de cadeia de caracteres do valor BigInteger resultante do uso de alguns especificadores de formato padrão. Os exemplos são exibidos usando as convenções de formatação da cultura 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

Comentários

O método ToString() formata um valor BigInteger no formato "R", ou ida e volta, da cultura atual. Se você quiser especificar um formato ou cultura diferente, use as outras sobrecargas do método ToString da seguinte maneira:

Para usar o formato	Para cultura	Usar a sobrecarga
Formato de ida e volta ("R")	Uma cultura específica	ToString
Um formato específico	Cultura padrão (atual)	ToString(String)
Um formato específico	Uma cultura específica	ToString(String, IFormatProvider)

A representação da cadeia de caracteres do valor BigInteger inclui um sinal negativo se o valor for negativo e uma sequência de dígitos variando de 0 a 9 sem zeros à esquerda. O sinal negativo é definido pelo objeto NumberFormatInfo para a cultura atual.

Confira também

cadeias de caracteres de formato numérico padrão
cadeias de caracteres de formato numérico personalizado

Aplica-se a

Compartilhar via

BigInteger.ToString Método

Definição

Sobrecargas

ToString(String, IFormatProvider)

Parâmetros

Retornos

Implementações

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

ToString(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

ToString(IFormatProvider)

Parâmetros

Retornos

Exemplos

Comentários

Aplica-se a

ToString()

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais