Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método Byte.ToString (String, IFormatProvider)

 

Publicado: agosto de 2016

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

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

public string ToString(
	string format,
	IFormatProvider provider
)

Parâmetros

format
Type: System.String

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

provider
Type: System.IFormatProvider

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

Valor Retornado

Type: System.String

A representação de cadeia de caracteres do atual Byte object, formatada conforme especificado pelo format e provider parâmetros.

Exception Condition
FormatException

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

O ToString(String, IFormatProvider) método formatos uma Byte valor em um formato especificado de uma cultura específica. Para formatar um número usando o formato padrão ("G") da cultura atual, chame o ToString() método. Para formatar um número usando um formato especificado da cultura atual, chame o ToString(String) método.

O format parâmetro pode ser um padrão ou uma cadeia de caracteres de formato numérico personalizado. Todas as cadeias de caracteres de formato numérico padrão diferente de "R" (ou "r") são suportadas, assim como todos os caracteres de formato numérico personalizado. Se format é null ou uma cadeia de caracteres vazia (""), o valor de retorno desse método é formatado com o especificador de formato numérico geral ("G").

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

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

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

  • Um objeto personalizado que implementa IFormatProvider.

Se provider é null ou NumberFormatInfo não é possível obter objeto de provider, o valor de retorno é formatado usando o NumberFormatInfo objeto 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 "N" e quatro diferentes CultureInfo objetos 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)      

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao início
Mostrar: