Compartilhar via


BigInteger.ToString Método

Definição

Converte o valor numérico do objeto BigInteger atual na representação da 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 de cultura.

ToString(String)

Converte o valor numérico do objeto BigInteger atual para 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 especificadas de formatação específicas de cultura.

ToString()

Converte o valor numérico do objeto BigInteger atual na representação da 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 de 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 padrão ou de formato numérico personalizado.

provider
IFormatProvider

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

Retornos

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

Implementações

Exceções

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

Exemplos

O exemplo a seguir inicializa um BigInteger valor e o exibe no console usando uma cadeia de caracteres de formato padrão e um NumberFormatInfo objeto 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 ToString(String, IFormatProvider) método formata um BigInteger valor em um formato especificado usando o NumberFormatInfo objeto 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 ToString método, 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 format parâmetro pode ser qualquer 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 atual BigInteger será formatado com o especificador de formato de viagem de ida e volta ("R"). Caso format tenha qualquer outro valor, o método lança um FormatException.

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

O parâmetro provider é uma implementação de IFormatProvider. O método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas de cultura sobre o formato da cadeia de caracteres retornada por esse método. Quando o ToString(String, IFormatProvider) método é invocado, ele chama o provider método do GetFormat parâmetro e passa a ele um Type objeto que representa o NumberFormatInfo tipo. Em GetFormat seguida, o método retorna o NumberFormatInfo objeto que fornece informações para formatar o value parâmetro, 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 provider parâmetro para fornecer informações de formatação ao ToString(String, IFormatProvider) método :

  • É possível passar um objeto CultureInfo que representa a cultura que fornece informações de formatação. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação numérica para essa cultura.

  • É possível passar o objeto real NumberFormatInfo que fornece informações de formatação numérica. (Sua implementação de GetFormat retorna apenas ele próprio.)

  • É possível passar um objeto personalizado que implementa IFormatProvider. O método GetFormat cria uma instância e retorna o objeto NumberFormatInfo que fornece informações de formatação.

Caso provider seja null, a formatação da cadeia de caracteres retornada baseia-se no objeto NumberFormatInfo da cultura atual.

Confira também

Aplica-se a

ToString(String)

Origem:
BigInteger.cs
Origem:
BigInteger.cs
Origem:
BigInteger.cs

Converte o valor numérico do objeto BigInteger atual para 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 padrão ou de formato numérico personalizado.

Retornos

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

Exceções

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

Exemplos

O exemplo a seguir inicializa um BigInteger valor 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 ToString(String) método formata um BigInteger valor em um formato especificado usando um NumberFormatInfo objeto 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 ToString método, 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 format parâmetro pode ser qualquer 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 atual BigInteger será formatado com o especificador de formato de viagem de ida e volta ("R"). Caso format tenha qualquer outro valor, o método lança um FormatException.

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos 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 do grupo e o símbolo da vírgula decimal na cadeia de caracteres de saída. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame a ToString(String, IFormatProvider) sobrecarga.

Confira também

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 especificadas de formatação específicas de cultura.

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

A representação de 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 personalizado NumberFormatInfo que define o bloco (~) como um sinal negativo. Em ToString(IFormatProvider) seguida, o método usa o objeto personalizado NumberFormatInfo para exibir um 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))

Comentários

O ToString(IFormatProvider) método formata um BigInteger valor no formato "R", ou ida e volta, usando o NumberFormatInfo objeto de uma cultura especificada. Se você quiser especificar um formato diferente ou a cultura atual, use as outras sobrecargas do ToString método, 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 de IFormatProvider. O método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas de cultura sobre o formato da cadeia de caracteres retornada por esse método. Se provider for null, o BigInteger valor será formatado usando o NumberFormatInfo objeto da cultura atual. A única propriedade do NumberFormatInfo objeto que controla a representação de cadeia de caracteres do BigInteger valor 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:

Aplica-se a

ToString()

Origem:
BigInteger.cs
Origem:
BigInteger.cs
Origem:
BigInteger.cs

Converte o valor numérico do objeto BigInteger atual na representação da 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

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

Exemplos

O exemplo a seguir exibe um BigInteger valor usando o método padrão ToString() . Ele também exibe as representações de cadeia de caracteres do BigInteger valor resultante do uso de alguns especificadores de formato padrão. Os exemplos são exibidos usando-se 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 ToString() método formata um BigInteger valor no formato "R", ou ida e volta, da cultura atual. Se você quiser especificar um formato ou cultura diferente, use as outras sobrecargas do ToString método, 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 de cadeia de caracteres do BigInteger valor inclui um sinal negativo se seu valor for negativo e uma sequência de dígitos variando de 0 a 9 sem zeros à esquerda. O sinal negativo é definido pelo NumberFormatInfo objeto para a cultura atual.

Confira também

Aplica-se a