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

String

A representação de 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 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.
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:

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 para formatação no .NET, consulte Tipos 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

String

A representação de 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 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)

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 .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 para 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 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

String

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

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:

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. O 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 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

String

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.
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 de 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 incluirá 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

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

Comentários

Recursos adicionais