Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método Byte.ToString (String, IFormatProvider)

Converte o valor do objeto atual de Byte em sua representação de cadeia de caracteres equivalente usando o formato especificado e informações específicas à cultura específica de formatação.

Namespace:  System
Assembly:  mscorlib (em mscorlib.dll)

public string ToString(
	string format,
	IFormatProvider provider
)

Parâmetros

format
Tipo: System.String
Uma cadeia de caracteres padrão ou de formato numérico personalizado.
provider
Tipo: System.IFormatProvider
Um objeto que fornece informações de formatação específicas de cultura.

Valor de retorno

Tipo: System.String
A representação de cadeia de caracteres do objeto atual de Byte , formatada conforme especificado pelas configurações de format e de provider .

Implementações

IFormattable.ToString(String, IFormatProvider)

ExceçãoCondição
FormatException

format inclui um especificador sem suporte. Os especificadores suporte de formato são listados na seção comentários.

O método de ToString(String, IFormatProvider) formata um valor de Byte em um formato especificado de uma cultura especificada. Para formatar um número usando (“G”) o formato padrão da cultura atual, chame o método de ToString() . Para formatar um número usando um formato especificado da cultura atual, chame o método de ToString(String) .

O parâmetro format pode ser uma cadeia de caracteres de formato numérico padrão ou personalizado. Todas as cadeias de caracteres de formato numérico padrão que não sejam "R" (ou "r") são suportadas, porque todos são caracteres de formato numérico personalizado. Se format é null ou uma cadeia de caracteres vazia (""), o valor de retorno desse método será formatado com o especificador numérico geral de formato (“G”).

O parâmetro provider é um objeto que implementa a interface IFormatProvider. O método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas de cultura sobre o formato da cadeia de caracteres que é retornada por esse método. O objeto que implementa IFormatProvider pode ser um dos seguintes:

  • Um objeto CultureInfo que representa a cultura cujas regras de formatação devem ser usadas.

  • Um objeto NumberFormatInfo que contém informações de formatação numérica específica para esse valor.

  • Um objeto personalizado que implementa IFormatProvider.

Se provider é null ou um objeto de NumberFormatInfo não pode ser obtido de provider, o valor de retorno será formatado com o objeto de NumberFormatInfo para a cultura atual do thread. Para obter informações sobre a cultura do thread atual, consulte Thread.CurrentCulture.

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

O exemplo a seguir usa a cadeia de caracteres de formato padrão de “N” e quatro objetos diferentes de CultureInfo para exibir a representação de cadeia de caracteres de um valor de byte para o console.


byte byteValue = 250;
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("es-es"), 
                           new CultureInfo("de-de")}; 

foreach (CultureInfo provider in providers) 
   Console.WriteLine("{0} ({1})", 
                     byteValue.ToString("N2", provider), provider.Name);
// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)      


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft