Byte.ToString Método

Definição

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.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 do objeto atual Byte em sua representação de cadeia de caracteres equivalente.

Sobrecargas

Nome	Description
ToString()	Converte o valor do objeto atual Byte em sua representação de cadeia de caracteres equivalente.
ToString(IFormatProvider)	Converte o valor numérico do objeto atual Byte em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.
ToString(String)	Converte o valor do objeto atual Byte em sua representação de cadeia de caracteres equivalente usando o formato especificado.
ToString(String, IFormatProvider)	Converte o valor do objeto atual Byte em sua representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formatação específicas da cultura.

ToString()

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Converte o valor do objeto atual Byte em sua representação de 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

A representação de cadeia de caracteres do valor desse objeto, que consiste em uma sequência de dígitos que variam de 0 a 9 sem zeros à esquerda.

Exemplos

O exemplo a seguir exibe uma matriz de valores de bytes. Observe que o ToString() método não é chamado explicitamente no exemplo. Em vez disso, ele é chamado implicitamente, devido ao uso do recurso de formatação composta , o exemplo de F# usa interpolação de cadeia de caracteres.

byte[] bytes = {0, 1, 14, 168, 255};
foreach (byte byteValue in bytes)
   Console.WriteLine(byteValue);
// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255

let bytes = [| 0; 1; 14; 168; 255 |]
for byteValue in bytes do
    printfn $"{byteValue}"

// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255

Dim bytes() As Byte = {0, 1, 14, 168, 255}
For Each byteValue As Byte In Bytes
   Console.WriteLine(byteValue)
Next   
' The example displays the following output to the console if the current
' culture is en-US:
'       0
'       1
'       14
'       168
'       255

Comentários

O valor retornado é formatado com o especificador de formato numérico geral ("G") e o NumberFormatInfo objeto para a cultura atual do thread. Para definir a formatação da Byte representação de cadeia de caracteres do valor, chame o ToString método. Para definir os especificadores de formato e a cultura usados para criar a representação de cadeia de caracteres de um Byte valor, chame o ToString método.

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 formatação, consulte Tipos de Formatação.

Para obter informações sobre a cultura atual do thread, consulte Thread.CurrentCulture.

Aplica-se a

ToString(IFormatProvider)

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Converte o valor numérico do objeto atual Byte em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificadas.

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

Retornos

String

A representação de cadeia de caracteres do valor desse objeto no formato especificado pelo provider parâmetro.

Implementações

ToString(IFormatProvider)

Exemplos

O exemplo a seguir itera uma matriz de valores de bytes e exibe cada um deles no console chamando o ToString(IFormatProvider) método com provedores de formato diferentes.

byte[] bytes = {0, 1, 14, 168, 255};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
foreach (byte byteValue in bytes)
{
   foreach (CultureInfo provider in providers)
      Console.Write("{0,3} ({1})      ",
                    byteValue.ToString(provider), provider.Name);

   Console.WriteLine();
}
// The example displays the following output to the console:
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

let bytes = [| 0; 1; 14; 168; 255 |]
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "de-de"
      CultureInfo "es-es" ]

for byteValue in bytes do
    for provider in providers do
        printf $"{byteValue.ToString provider,3} ({provider.Name})      " 

    printfn ""

// The example displays the following output to the console:
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

Dim bytes() As Byte = {0, 1, 14, 168, 255}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each byteValue As Byte In bytes
   For Each provider As CultureInfo In providers
      Console.Write("{0,3} ({1})      ", byteValue.ToString(provider), provider.Name)
   Next
   Console.WriteLine()                                        
Next
' The example displays the following output to the console:
'      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
'      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
'     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
'    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
'    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

Comentários

O valor retornado é formatado com o especificador de formato numérico geral ("G").

O provider parâmetro é um objeto que implementa a 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 retornada por esse método. O objeto que implementa pode ser qualquer um dos seguintes IFormatProvider :

Um CultureInfo objeto que representa a cultura cujas regras de formatação devem ser usadas.
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 for null ou um NumberFormatInfo objeto não puder ser obtido provider, o valor retornado será formatado usando o NumberFormatInfo objeto para a cultura atual do thread. Para obter informações sobre a cultura atual do thread, consulte Thread.CurrentCulture.

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 formatação, consulte Tipos de Formatação.

Confira também

Aplica-se a

ToString(String)

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Converte o valor do objeto atual Byte em 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 de formato numérico.

Retornos

String

A representação de cadeia de caracteres do objeto atual Byte , formatada conforme especificado pelo format parâmetro.

Exceções

FormatException

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

Exemplos

O exemplo a seguir inicializa um valor e o exibe no console usando cada uma Byte das cadeias de caracteres de formato padrão com suporte e uma cadeia de caracteres de formato personalizado. O exemplo é executado com en-US como a cultura atual.

string[] formats = {"C3", "D4", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "0000.0000"};
byte number = 240;
foreach (string format in formats)
   Console.WriteLine("'{0}' format specifier: {1}",
                     format, number.ToString(format));

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000

let formats = 
    [ "C3"; "D4"; "e1"; "E2"; "F1"; "G"; "N1"
      "P0"; "X4"; "0000.0000" ]
let number = 240uy
for format in formats do
    printfn $"'{format}' format specifier: {number.ToString format}"

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000

Dim formats() As String = {"C3", "D4", "e1", "E2", "F1", "G", _
                           "N1", "P0", "X4", "0000.0000"}
Dim number As Byte = 240
For Each format As String In formats
   Console.WriteLine("'{0}' format specifier: {1}", _
                     format, number.ToString(format))
Next  
' The example displays the following output to the console if the
' current culture is en-us:
'       'C3' format specifier: $240.000
'       'D4' format specifier: 0240
'       'e1' format specifier: 2.4e+002
'       'E2' format specifier: 2.40E+002
'       'F1' format specifier: 240.0       
'       'G' format specifier: 240
'       'N1' format specifier: 240.0
'       'P0' format specifier: 24,000 %
'       'X4' format specifier: 00F0
'       '0000.0000' format specifier: 0240.0000

Comentários

O format parâmetro pode ser uma cadeia de caracteres de formato numérico padrão ou personalizada. Todas as cadeias de caracteres de formato numérico padrão que não sejam "R" (ou "r") têm suporte, assim como todos os caracteres de formato numérico personalizados. Se format for null ou uma cadeia de caracteres vazia (""), o valor retornado será formatado com o especificador de formato numérico geral ("G").

O valor retornado dessa função é formatado usando o NumberFormatInfo objeto para a cultura atual do thread. Para obter informações sobre a cultura atual do thread, consulte Thread.CurrentCulture. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame o Byte.ToString(String, IFormatProvider) método.

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 formatação, consulte Tipos de Formatação.

Confira também

Como adicionar um número com zeros à esquerda

Aplica-se a

ToString(String, IFormatProvider)

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Origem:: Byte.cs

Converte o valor do objeto atual Byte em sua representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formatação específicas 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 caracteres de formato numérico padrão ou 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 objeto atual Byte , formatada conforme especificado pelo format parâmetro e provider pelos parâmetros.

Implementações

ToString(String, IFormatProvider)

Exceções

FormatException

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

Exemplos

O exemplo a seguir usa a cadeia de caracteres de formato "N" padrão e quatro objetos diferentes CultureInfo para exibir a representação de cadeia de caracteres de um valor de byte no 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)

let byteValue = 250uy
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "es-es"
      CultureInfo "de-de" ]

for provider in providers do
    printfn $"""{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)

Dim byteValue As Byte = 250
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("es-es"), _
                                  New CultureInfo("de-de")} 
For Each provider As CultureInfo In providers 
   Console.WriteLine("{0} ({1})", _
                     byteValue.ToString("N2", provider), provider.Name)
Next   
' 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)

Comentários

O ToString(String, IFormatProvider) método formata um Byte valor em um formato especificado de uma cultura especificada. 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 uma cadeia de caracteres de formato numérico padrão ou personalizada. Todas as cadeias de caracteres de formato numérico padrão que não sejam "R" (ou "r") têm suporte, assim como todos os caracteres de formato numérico personalizados. Se format for null ou uma cadeia de caracteres vazia (""), o valor retornado desse método será formatado com o especificador de formato numérico geral ("G").

Um CultureInfo objeto que representa a cultura cujas regras de formatação devem ser usadas.
Um NumberFormatInfo objeto que contém informações de formatação numérica específicas para esse valor.
Um objeto personalizado que implementa 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 formatação, consulte Tipos de Formatação.

Confira também

Aplica-se a

Comentários

Esta página foi útil?