Single.ToString Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Converte o valor numérico desta instância para a sua representação equivalente em cadeias.
Sobrecargas
| Name | Description |
|---|---|
| ToString() |
Converte o valor numérico desta instância para a sua representação equivalente em cadeias. |
| ToString(IFormatProvider) |
Converte o valor numérico desta instância para a sua representação equivalente de cadeias usando a informação de formato específica da cultura especificada. |
| ToString(String) |
Converte o valor numérico desta instância para a sua representação equivalente em cadeias, usando o formato especificado. |
| ToString(String, IFormatProvider) |
Converte o valor numérico desta instância para a sua representação equivalente de cadeias usando o formato especificado e a informação específica de formato da cultura. |
ToString()
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
Converte o valor numérico desta instância para a sua representação equivalente em cadeias.
public:
override System::String ^ ToString();
public override string ToString();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Devoluções
A representação da cadeia do valor desta instância.
Exemplos
O exemplo seguinte usa o método padrão Single.ToString para mostrar as representações das cadeias de vários Single valores.
float number;
number = 1.6E20F;
// Displays 1.6E+20.
Console.WriteLine(number.ToString());
number = 1.6E2F;
// Displays 160.
Console.WriteLine(number.ToString());
number = -3.541F;
// Displays -3.541.
Console.WriteLine(number.ToString());
number = -1502345222199E-07F;
// Displays -150234.5222199.
Console.WriteLine(number.ToString());
number = -15023452221990199574E-09F;
// Displays -15023452221.9902.
Console.WriteLine(number.ToString());
number = .60344F;
// Displays 0.60344.
Console.WriteLine(number.ToString());
number = .000000001F;
// Displays 1E-09.
Console.WriteLine(number.ToString());
let number = 1.6E20F
// Displays 1.6E+20.
printfn $"{number.ToString()}"
let number = 1.6E2F
// Displays 160.
printfn $"{number.ToString()}"
let number = -3.541F
// Displays -3.541.
printfn $"{number.ToString()}"
let number = -1502345222199E-07F
// Displays -150234.5222199.
printfn $"{number.ToString()}"
let number = -15023452221990199574E-09F
// Displays -15023452221.9902.
printfn $"{number.ToString()}"
let number = 0.60344F
// Displays 0.60344.
printfn $"{number.ToString()}"
let number = 0.000000001F
// Displays 1E-09.
printfn $"{number.ToString()}"
Dim number As Single
number = 1.6E20
' Displays 1.6E+20.
Console.WriteLine(number.ToString())
number = 1.6E2
' Displays 160.
Console.WriteLine(number.ToString())
number = -3.541
' Displays -3.541.
Console.WriteLine(number.ToString())
number = -1502345222199E-07
' Displays -150234.5222199.
Console.WriteLine(number.ToString())
number = -15023452221990199574E-09
' Displays -15023452221.9902.
Console.WriteLine(number.ToString())
number = .60344
' Displays 0.60344.
Console.WriteLine(number.ToString())
number = .000000001
' Displays 1E-09.
Console.WriteLine(number.ToString())
O seguinte exemplo de código ilustra a utilização do Parse(String) método juntamente com o ToString() método.
bool done = false;
string inp;
do
{
Console.Write("Enter a real number: ");
inp = Console.ReadLine();
try
{
s = Single.Parse(inp);
Console.WriteLine("You entered {0}.", s.ToString());
done = true;
}
catch (FormatException)
{
Console.WriteLine("You did not enter a number.");
}
catch (Exception e)
{
Console.WriteLine("An exception occurred while parsing your response: {0}", e.ToString());
}
} while (!done);
let mutable finished = false
while not finished do
printf "Enter a real number: "
let inp = stdin.ReadLine()
try
let s = Single.Parse inp
printfn $"You entered {s}."
finished <- true
with
| :? FormatException ->
printfn "You did not enter a number."
| e ->
printfn "An exception occurred while parsing your response: {e}"
Dim Done As Boolean = False
Dim Inp As String
Do
Console.Write("Enter a real number: ")
Inp = Console.ReadLine()
Try
S = Single.Parse(Inp)
Console.WriteLine("You entered " + S.ToString() + ".")
Done = True
Catch E As FormatException
Console.WriteLine("You did not enter a number.")
Catch E As Exception
Console.WriteLine("An exception occurred while parsing your response: " + E.ToString())
End Try
Loop While Not Done
Observações
O ToString() método formata um Single valor no formato padrão ("G", ou geral) da cultura atual. Se quiser especificar um formato ou cultura diferente, use as outras sobrecargas do ToString método, da seguinte forma:
| Para usar o formato | Pela cultura | Usa a sobrecarga |
|---|---|---|
| Formato padrão ("G") | Uma cultura específica | ToString(IFormatProvider) |
| Um formato específico | Cultura padrão (atual) | ToString(String) |
| Um formato específico | Uma cultura específica | ToString(String, IFormatProvider) |
O valor de retorno pode ser PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, ou uma cadeia da forma:
[signo] dígitos integrais[.[ dígitos fracionários]][dígitos exponenciais e[signo]]
Os elementos opcionais estão enquadrados entre colchetes quadrados ([ e ]). Os elementos que contêm o termo "dígitos" consistem numa série de caracteres numéricos que variam de 0 a 9. A tabela seguinte lista cada elemento:
| Elemento | Descrição |
|---|---|
| assinar | Um sinal negativo ou símbolo positivo. |
| dígitos integrais | Uma série de dígitos que especificam a parte integral do número. Os dígitos integrais podem estar ausentes se existirem dígitos fracionários. |
| '.' | Um símbolo de ponto decimal específico para cada cultura. |
| Dígitos fracionários | Uma série de dígitos que especificam a parte fracionária do número. |
| 'E' | Um caractere minúsculo 'e', indicando notação exponencial (científica). |
| Dígitos exponenciais | Uma série de dígitos que especificam um expoente. |
Alguns exemplos do valor de retorno são "100", "-123.456.789", "123.45e+6", "500", "3.1416", "600", "-0.123" e "-Infinito".
O .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:
Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre formatação, consulte Tipos de Formatação.
Ver também
Aplica-se a
ToString(IFormatProvider)
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
Converte o valor numérico desta instância para a sua representação equivalente de cadeias usando a informação de formato específica da cultura especificada.
public:
virtual System::String ^ ToString(IFormatProvider ^ provider);
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ção de formatação específica para cada cultura.
Devoluções
A representação da cadeia do valor desta instância conforme especificado por provider.
Implementações
Exemplos
O exemplo seguinte mostra a representação em cadeia de dois Single valores usando CultureInfo objetos que representam várias culturas diferentes.
float value;
value = -16325.62015F;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
value = 16034.125E21F;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
// -16325.62015
// -16325.62015
// -16325,62015
// 1.6034125E+25
// 1.6034125E+25
// 1,6034125E+25
let value = -16325.62015F
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""
let value = 16034.125E21F
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""
// This example displays the following output to the console:
// -16325.62015
// -16325.62015
// -16325,62015
// 1.6034125E+25
// 1.6034125E+25
// 1,6034125E+25
Dim value As Single
value = -16325.62015
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
value = 16034.125E21
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
' -16325.62015
' -16325.62015
' -16325,62015
' 1.6034125E+25
' 1.6034125E+25
' 1,6034125E+25
Observações
O ToString(IFormatProvider) método formata um Single valor no formato padrão ("G", ou geral) de uma cultura especificada. Se quiser especificar um formato diferente ou a cultura atual, use as outras sobrecargas do ToString método, da seguinte forma:
| Para usar o formato | Pela cultura | Usa a sobrecarga |
|---|---|---|
| Formato padrão ("G") | 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 valor de retorno pode ser PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, ou uma cadeia da forma:
[signo] dígitos integrais[.[ dígitos fracionários]][dígitos exponenciais e[signo]]
Os elementos opcionais estão enquadrados entre colchetes quadrados ([ e ]). Os elementos que contêm o termo "dígitos" consistem numa série de caracteres numéricos que variam de 0 a 9. A tabela seguinte lista cada elemento.
| Elemento | Descrição |
|---|---|
| sign | Um sinal negativo ou símbolo positivo. |
| dígitos integrais | Uma série de dígitos que especificam a parte integral do número. Os dígitos integrais podem estar ausentes se existirem dígitos fracionários. |
| '.' | Um símbolo de ponto decimal específico para cada cultura. |
| Dígitos fracionários | Uma série de dígitos que especificam a parte fracionária do número. |
| 'E' | Um caractere minúsculo 'e', indicando notação exponencial (científica). |
| Dígitos exponenciais | Uma série de dígitos que especificam um expoente. |
Alguns exemplos do valor de retorno são "100", "-123.456.789", "123.45e+6", "500", "3.1416", "600", "-0.123" e "-Infinito".
O .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:
Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre formatação, consulte Tipos de Formatação.
O provider parâmetro é uma IFormatProvider implementação cujo GetFormat método devolve um NumberFormatInfo objeto. Normalmente, provider é um CultureInfo objeto ou um NumberFormatInfo objeto. O provider parâmetro fornece informação específica da cultura utilizada na formatação. Se provider for null, o valor de retorno é formatado usando os NumberFormatInfo dados da cultura atual.
Para converter um Single valor para a sua representação de cadeia usando uma cultura especificada e uma cadeia de formato específica, chama o Single.ToString(String, IFormatProvider) método.
Ver também
Aplica-se a
ToString(String)
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
Converte o valor numérico desta instância para a sua representação equivalente em cadeias, 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 formato numérico.
Devoluções
A representação da cadeia do valor desta instância conforme especificado por format.
Exceções
format é inválido.
Exemplos
O exemplo seguinte define um valor numérico e formata-o como valor de moeda usando a cadeia de formato numérico padrão "C" e como valor numérico para três casas decimais, usando a cadeia de formato numérico padrão "N". As cadeias de resultados são formatadas usando as convenções da cultura en-US. Para mais informações sobre cadeias de formatos numéricos, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
using System;
public class Example
{
public static void Main()
{
Double number = 1764.3789;
// Format as a currency value.
Console.WriteLine(number.ToString("C"));
// Format as a numeric value with 3 decimal places.
Console.WriteLine(number.ToString("N3"));
}
}
// The example displays the following output:
// $1,764.38
// 1,764.379
let number = 1764.3789
// Format as a currency value.
printfn $"""{number.ToString "C"}"""
// Format as a numeric value with 3 decimal places.
printfn $"""{number.ToString "N3"}"""
// The example displays the following output:
// $1,764.38
// 1,764.379
Module Example
Public Sub Main()
Dim number As Single = 1764.3789
' Format as a currency value.
Console.WriteLine(number.ToString("C"))
' Format as a numeric value with 3 decimal places.
Console.WriteLine(number.ToString("N3"))
End Sub
End Module
' The example displays the following output:
' $1,764.38
' 1,764.379
O exemplo seguinte apresenta vários Single valores usando cada um dos especificadores de formato numérico padrão suportados, juntamente com duas cadeias de formatos numéricos personalizadas. Uma dessas cadeias de formatos personalizados ilustra como preencher um Single valor com zeros à esquerda. Ao converter os valores numéricos em cadeias, o exemplo utiliza as convenções de formatação da cultura en-US.
float[] numbers= { 1054.32179F, -195489100.8377F, 1.0437E21F,
-1.0573e-05F };
string[] specifiers = { "C", "E", "e", "F", "G", "N", "P",
"R", "#,000.000", "0.###E-000",
"000,000,000,000.00###" };
foreach (float number in numbers)
{
Console.WriteLine("Formatting of {0}:", number);
foreach (string specifier in specifiers)
Console.WriteLine(" {0,5}: {1}",
specifier, number.ToString(specifier));
Console.WriteLine();
}
// The example displays the following output to the console:
// Formatting of 1054.32179:
// C: $1,054.32
// E: 1.054322E+003
// e: 1.054322e+003
// F: 1054.32
// G: 1054.32179
// N: 1,054.32
// P: 105,432.18 %
// R: 1054.32179
// #,000.000: 1,054.322
// 0.###E-000: 1.054E003
// 000,000,000,000.00###: 000,000,001,054.322
//
// Formatting of -195489100.8377:
// C: ($195,489,100.84)
// E: -1.954891E+008
// e: -1.954891e+008
// F: -195489100.84
// G: -195489100.8377
// N: -195,489,100.84
// P: -19,548,910,083.77 %
// R: -195489100.8377
// #,000.000: -195,489,100.838
// 0.###E-000: -1.955E008
// 000,000,000,000.00###: -000,195,489,100.00
//
// Formatting of 1.0437E+21:
// C: $1,043,700,000,000,000,000,000.00
// E: 1.043700E+021
// e: 1.043700e+021
// F: 1043700000000000000000.00
// G: 1.0437E+21
// N: 1,043,700,000,000,000,000,000.00
// P: 104,370,000,000,000,000,000,000.00 %
// R: 1.0437E+21
// #,000.000: 1,043,700,000,000,000,000,000.000
// 0.###E-000: 1.044E021
// 000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//
// Formatting of -1.0573E-05:
// C: $0.00
// E: -1.057300E-005
// e: -1.057300e-005
// F: 0.00
// G: -1.0573E-05
// N: 0.00
// P: 0.00 %
// R: -1.0573E-05
// #,000.000: 000.000
// 0.###E-000: -1.057E-005
// 000,000,000,000.00###: -000,000,000,000.00001
let numbers =
[| 1054.32179F; -195489100.8377F; 1.0437E21F; -1.0573e-05F |]
let specifiers =
[| "C"; "E"; "e"; "F"; "G"; "N"; "P"
"R"; "#,000.000"; "0.###E-000"
"000,000,000,000.00###" |]
for number in numbers do
printfn $"Formatting of {number}:"
for specifier in specifiers do
printfn $" {specifier,5}: {number.ToString specifier}"
printfn ""
// The example displays the following output to the console:
// Formatting of 1054.32179:
// C: $1,054.32
// E: 1.054322E+003
// e: 1.054322e+003
// F: 1054.32
// G: 1054.32179
// N: 1,054.32
// P: 105,432.18 %
// R: 1054.32179
// #,000.000: 1,054.322
// 0.###E-000: 1.054E003
// 000,000,000,000.00###: 000,000,001,054.322
//
// Formatting of -195489100.8377:
// C: ($195,489,100.84)
// E: -1.954891E+008
// e: -1.954891e+008
// F: -195489100.84
// G: -195489100.8377
// N: -195,489,100.84
// P: -19,548,910,083.77 %
// R: -195489100.8377
// #,000.000: -195,489,100.838
// 0.###E-000: -1.955E008
// 000,000,000,000.00###: -000,195,489,100.00
//
// Formatting of 1.0437E+21:
// C: $1,043,700,000,000,000,000,000.00
// E: 1.043700E+021
// e: 1.043700e+021
// F: 1043700000000000000000.00
// G: 1.0437E+21
// N: 1,043,700,000,000,000,000,000.00
// P: 104,370,000,000,000,000,000,000.00 %
// R: 1.0437E+21
// #,000.000: 1,043,700,000,000,000,000,000.000
// 0.###E-000: 1.044E021
// 000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//
// Formatting of -1.0573E-05:
// C: $0.00
// E: -1.057300E-005
// e: -1.057300e-005
// F: 0.00
// G: -1.0573E-05
// N: 0.00
// P: 0.00 %
// R: -1.0573E-05
// #,000.000: 000.000
// 0.###E-000: -1.057E-005
// 000,000,000,000.00###: -000,000,000,000.00001
Dim numbers() As Single = {1054.32179, -195489100.8377, 1.0437E21, _
-1.0573e-05}
Dim specifiers() As String = { "C", "E", "e", "F", "G", "N", "P", _
"R", "#,000.000", "0.###E-000", _
"000,000,000,000.00###"}
For Each number As Single In numbers
Console.WriteLine("Formatting of {0}:", number)
For Each specifier As String In specifiers
Console.WriteLine(" {0,5}: {1}", _
specifier, number.ToString(specifier))
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
' Formatting of 1054.32179:
' C: $1,054.32
' E: 1.054322E+003
' e: 1.054322e+003
' F: 1054.32
' G: 1054.32179
' N: 1,054.32
' P: 105,432.18 %
' R: 1054.32179
' #,000.000: 1,054.322
' 0.###E-000: 1.054E003
' 000,000,000,000.00###: 000,000,001,054.322
'
' Formatting of -195489100.8377:
' C: ($195,489,100.84)
' E: -1.954891E+008
' e: -1.954891e+008
' F: -195489100.84
' G: -195489100.8377
' N: -195,489,100.84
' P: -19,548,910,083.77 %
' R: -195489100.8377
' #,000.000: -195,489,100.838
' 0.###E-000: -1.955E008
' 000,000,000,000.00###: -000,195,489,100.00
'
' Formatting of 1.0437E+21:
' C: $1,043,700,000,000,000,000,000.00
' E: 1.043700E+021
' e: 1.043700e+021
' F: 1043700000000000000000.00
' G: 1.0437E+21
' N: 1,043,700,000,000,000,000,000.00
' P: 104,370,000,000,000,000,000,000.00 %
' R: 1.0437E+21
' #,000.000: 1,043,700,000,000,000,000,000.000
' 0.###E-000: 1.044E021
' 000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
'
' Formatting of -1.0573E-05:
' C: $0.00
' E: -1.057300E-005
' e: -1.057300e-005
' F: 0.00
' G: -1.0573E-05
' N: 0.00
' P: 0.00 %
' R: -1.0573E-05
' #,000.000: 000.000
' 0.###E-000: -1.057E-005
' 000,000,000,000.00###: -000,000,000,000.00001
Observações
O ToString(String) método formata um Single valor num formato especificado usando as convenções da cultura atual. Se quiser usar o formato padrão ("G", ou geral) ou especificar uma cultura diferente, use as outras sobrecargas do ToString método, da seguinte forma:
| Para usar o formato | Pela cultura | Usa a sobrecarga |
|---|---|---|
| Formato padrão ("G") | Cultura padrão (atual) | ToString() |
| Formato padrão ("G") | Uma cultura específica | ToString(IFormatProvider) |
| Um formato específico | Uma cultura específica | ToString(String, IFormatProvider) |
O valor de retorno pode ser PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, ou a representação da cadeia do valor da instância atual, conforme especificado por format.
O format parâmetro pode ser qualquer especificador de formato numérico padrão válido, exceto D e X, bem como qualquer combinação de especificadores de formato numérico personalizados. Se o formato for null ou uma cadeia vazia, o valor de retorno é formatado com o especificador numérico geral de formato ("G").
O .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:
Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre formatação, consulte Tipos de Formatação.
Por defeito, o valor de retorno contém apenas 7 dígitos de precisão, embora internamente se mantenha um máximo de 9 dígitos. Se o valor desta instância tiver mais de 7 dígitos, ToString(String) retorna PositiveInfinitySymbol ou NegativeInfinitySymbol em vez do número esperado. Se precisar de mais precisão, especifique format com a especificação do formato "G9", que devolve sempre 9 dígitos de precisão, ou "R", que devolve 7 dígitos se o número puder ser representado com essa precisão ou 9 dígitos se o número só puder ser representado com máxima precisão.
Ver também
Aplica-se a
ToString(String, IFormatProvider)
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
- Origem:
- Single.cs
Converte o valor numérico desta instância para a sua representação equivalente de cadeias usando o formato especificado e a informação específica de formato 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 formato numérico.
- provider
- IFormatProvider
Um objeto que fornece informação de formatação específica para cada cultura.
Devoluções
A representação da cadeia do valor desta instância conforme especificado por format e provider.
Implementações
Exemplos
O exemplo seguinte apresenta um Single valor usando cada um dos especificadores de formato numérico padrão suportados para várias culturas diferentes.
float value = 16325.62901F;
string specifier;
CultureInfo culture;
// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 16325,62901
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays: 16325.62901
specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: $16,325.63
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: £16,325.63
specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004
culture = CultureInfo.CreateSpecificCulture("en-NZ");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1.6326E+004
specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 16325,63
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 16325.63
specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 16.325,63
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 16 325,63
specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays: 163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays: 163.256 %
let value = 16325.62901F
// Use standard numeric format specifiers.
let specifier = "G"
let culture = CultureInfo.CreateSpecificCulture "eu-ES"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 16325,62901
printfn $"{value.ToString(specifier, CultureInfo.InvariantCulture)}"
// Displays: 16325.62901
let specifier = "C"
let culture = CultureInfo.CreateSpecificCulture "en-US"
printfn $"{value.ToString(specifier, culture)}"
// Displays: $16,325.63
let culture = CultureInfo.CreateSpecificCulture "en-GB"
printfn $"{value.ToString(specifier, culture)}"
// Displays: £16,325.63
let specifier = "E04"
let culture = CultureInfo.CreateSpecificCulture "sv-SE"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 1,6326E+004
let culture = CultureInfo.CreateSpecificCulture "en-NZ"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 1.6326E+004
let specifier = "F"
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 16325,63
let culture = CultureInfo.CreateSpecificCulture "en-CA"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 16325.63
let specifier = "N"
let culture = CultureInfo.CreateSpecificCulture "es-ES"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 16.325,63
let culture = CultureInfo.CreateSpecificCulture "fr-CA"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 16 325,63
let specifier = "P"
let culture = CultureInfo.InvariantCulture
printfn $"{(value / 10000f).ToString(specifier, culture)}"
// Displays: 163.26 %
let culture = CultureInfo.CreateSpecificCulture "ar-EG"
printfn $"{(value / 10000f).ToString(specifier, culture)}"
// Displays: 163.256 %
Dim value As Single = 16325.62901
Dim specifier As String
Dim culture As CultureInfo
' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 16325,62901
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays: 16325.62901
specifier = "C"
culture = CultureInfo.CreateSpecificCulture("en-US")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: $16,325.63
culture = CultureInfo.CreateSpecificCulture("en-GB")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: £16,325.63
specifier = "E04"
culture = CultureInfo.CreateSpecificCulture("sv-SE")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1,6326E+004
culture = CultureInfo.CreateSpecificCulture("en-NZ")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1.6326E+004
specifier = "F"
culture = CultureInfo.CreateSpecificCulture("fr-FR")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 16325,63
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 16325.63
specifier = "N"
culture = CultureInfo.CreateSpecificCulture("es-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 16.325,63
culture = CultureInfo.CreateSpecificCulture("fr-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 16 325,63
specifier = "P"
culture = CultureInfo.InvariantCulture
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays: 163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG")
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays: 163.256 %
Observações
O ToString(String, IFormatProvider) método formata um Single valor num formato especificado de uma cultura especificada. Se quiser usar definições de formato ou cultura por defeito, use as outras sobrecargas do ToString método, da seguinte forma:
| Para usar o formato | Pela cultura | Usa a sobrecarga |
|---|---|---|
| Formato padrão ("G") | Cultura padrão (atual) | ToString() |
| Formato padrão ("G") | Uma cultura específica | ToString(IFormatProvider) |
| Um formato específico | Cultura padrão (atual) | ToString(String) |
O valor de retorno pode ser PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, ou a representação da cadeia do valor da instância atual, conforme especificado por format.
O format parâmetro pode ser qualquer especificador de formato numérico padrão válido, exceto D e X, bem como qualquer combinação de especificadores de formato numérico personalizados. Se format for null ou uma cadeia vazia, o valor de retorno para esta instância é formatado com o especificador de formato numérico geral ("G").
O .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:
Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre formatação, consulte Tipos de Formatação.
O provider parâmetro é uma IFormatProvider implementação cujo GetFormat método devolve um NumberFormatInfo objeto. Normalmente, provider é um CultureInfo objeto ou um NumberFormatInfo objeto. O provider parâmetro fornece informação específica da cultura utilizada na formatação. Se provider for null, o valor de retorno é formatado com o NumberFormatInfo objeto para a cultura atual.
Por defeito, o valor de retorno contém apenas 7 dígitos de precisão, embora internamente se mantenha um máximo de 9 dígitos. Se o valor desta instância tiver mais de 7 dígitos, ToString retorna PositiveInfinitySymbol ou NegativeInfinitySymbol em vez do número esperado. Se precisar de mais precisão, especifique format com a especificação do formato "G9", que devolve sempre 9 dígitos de precisão, ou "R", que devolve 7 dígitos se o número puder ser representado com essa precisão ou 9 dígitos se o número só puder ser representado com máxima precisão.