Byte.ToString Byte.ToString Byte.ToString Byte.ToString Method

Definição

Converte o valor do atual objeto Byte na representação de cadeia de caracteres equivalente.Converts the value of the current Byte object to its equivalent string representation.

Sobrecargas

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Converte o valor numérico do objeto Byte atual em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificada.Converts the numeric value of the current Byte object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Converte o valor do objeto Byte atual na representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formatação específicas da cultura.Converts the value of the current Byte object to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

Converte o valor do objeto Byte atual em sua representação de cadeia de caracteres equivalente usando o formato especificado.Converts the value of the current Byte object to its equivalent string representation using the specified format.

ToString() ToString() ToString() ToString()

Converte o valor do atual objeto Byte na representação de cadeia de caracteres equivalente.Converts the value of the current Byte object to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Converte o valor numérico do objeto Byte atual em sua representação de cadeia de caracteres equivalente usando as informações de formatação específicas da cultura especificada.Converts the numeric value of the current Byte object to its equivalent string representation using the specified culture-specific formatting information.

public:
 System::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 IFormatProvider IFormatProvider IFormatProvider

Um objeto que fornece informações de formatação específicas de cultura.An object that supplies culture-specific formatting information.

Retornos

A representação de cadeia de caracteres do valor desse objeto no formato especificado pelo parâmetro provider.The string representation of the value of this object in the format specified by the provider parameter.

Implementações

Exemplos

O exemplo a seguir itera uma matriz de valores de bytes e exibe cada um deles no console chamando o método ToString(IFormatProvider) com provedores de formato diferentes.The following example iterates an array of byte values and displays each of them to the console by calling the ToString(IFormatProvider) method with different format providers.

array<Byte>^ bytes = gcnew array<Byte> {0, 1, 14, 168, 255};
array<CultureInfo^>^ providers = {gcnew CultureInfo("en-us"), 
                                  gcnew CultureInfo("fr-fr"), 
                                  gcnew CultureInfo("de-de"), 
                                  gcnew CultureInfo("es-es")};
for each (Byte byteValue in bytes)
{
   for each (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)            
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)            
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 de retorno é formatado com o especificador de formato numérico geral ("G").The return value is formatted with the general numeric format specifier ("G").

O parâmetro provider é um objeto que implementa a interface IFormatProvider.The provider parameter is an object that implements the IFormatProvider interface. 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.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. O objeto que implementa IFormatProvider pode ser um dos seguintes:The object that implements IFormatProvider can be any of the following:

  • Um objeto CultureInfo que representa a cultura cujas regras de formatação devem ser usadas.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Um objeto NumberFormatInfo que contém informações de formatação numérica específica para esse valor.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Um objeto personalizado que implementa IFormatProvider.A custom object that implements IFormatProvider.

Se provider for null ou um provider NumberFormatInfo objeto não puder ser obtido de, o valor de retorno será formatado usando o objeto para a cultura de thread atual. NumberFormatInfoIf provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. Para obter informações sobre a cultura do thread atual, consulte Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

O .NET Framework fornece extenso suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Veja também

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Converte o valor do objeto Byte atual na representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formatação específicas da cultura.Converts the value of the current Byte object to its equivalent string representation using the specified format and culture-specific formatting information.

public:
 virtual System::String ^ ToString(System::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 String String String

Uma cadeia de caracteres padrão ou de formato numérico personalizado.A standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Um objeto que fornece informações de formatação específicas de cultura.An object that supplies culture-specific formatting information.

Retornos

A representação de cadeia de caracteres do objeto Byte atual, formatado conforme especificado pelos parâmetros format e provider.The string representation of the current Byte object, formatted as specified by the format and provider parameters.

Implementações

Exceções

format inclui um especificador sem suporte.format includes an unsupported specifier. Especificadores de formato com suporte são listados na seção Comentários.Supported format specifiers are listed in the Remarks section.

Exemplos

O exemplo a seguir usa a cadeia de caracteres de formato "N" CultureInfo padrão e quatro objetos diferentes para exibir a representação de cadeia de caracteres de um valor de byte para o console.The following example uses the standard "N" format string and four different CultureInfo objects to display the string representation of a byte value to the console.

Byte byteValue = 250;
array<CultureInfo^>^ providers = gcnew array<CultureInfo^> { gcnew CultureInfo("en-us"), 
                                                             gcnew CultureInfo("fr-fr"), 
                                                             gcnew CultureInfo("es-es"), 
                                                             gcnew CultureInfo("de-de")}; 

for each (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)  
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)      
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.The ToString(String, IFormatProvider) method formats a Byte value in a specified format of a specified culture. Para formatar um número usando o formato padrão ("G") da cultura atual, chame o ToString() método.To format a number by using the default ("G") format of the current culture, call the ToString() method. Para formatar um número usando um formato especificado da cultura atual, chame o ToString(String) método.To format a number by using a specified format of the current culture, call the ToString(String) method.

O parâmetro format pode ser uma cadeia de caracteres de formato numérico padrão ou personalizado.The format parameter can be either a standard or a custom numeric format string. 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.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Se format fornull ou uma cadeia de caracteres vazia (""), o valor de retorno desse método será formatado com o especificador de formato numérico geral ("G").If format is null or an empty string (""), the return value of this method is formatted with the general numeric format specifier ("G").

O parâmetro provider é um objeto que implementa a interface IFormatProvider.The provider parameter is an object that implements the IFormatProvider interface. 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.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. O objeto que implementa IFormatProvider pode ser um dos seguintes:The object that implements IFormatProvider can be any of the following:

  • Um objeto CultureInfo que representa a cultura cujas regras de formatação devem ser usadas.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Um objeto NumberFormatInfo que contém informações de formatação numérica específica para esse valor.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Um objeto personalizado que implementa IFormatProvider.A custom object that implements IFormatProvider.

Se provider for null ou um provider NumberFormatInfo objeto não puder ser obtido de, o valor de retorno será formatado usando o objeto para a cultura de thread atual. NumberFormatInfoIf provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. Para obter informações sobre a cultura do thread atual, consulte Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

O .NET Framework fornece extenso suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Veja também

ToString(String) ToString(String) ToString(String) ToString(String)

Converte o valor do objeto Byte atual em sua representação de cadeia de caracteres equivalente usando o formato especificado.Converts the value of the current Byte object to its equivalent string representation using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parâmetros

format
String String String String

Uma cadeia de caracteres de formato numérico.A numeric format string.

Retornos

A representação de cadeia de caracteres do objeto Byte atual, formatado conforme especificado pelo parâmetro format.The string representation of the current Byte object, formatted as specified by the format parameter.

Exceções

format inclui um especificador sem suporte.format includes an unsupported specifier. Especificadores de formato com suporte são listados na seção Comentários.Supported format specifiers are listed in the Remarks section.

Exemplos

O exemplo a seguir inicializa Byte um valor e o exibe para o console usando cada uma das cadeias de caracteres de formato padrão com suporte e uma cadeia de formato personalizado.The following example initializes a Byte value and displays it to the console using each of the supported standard format strings and a custom format string. O exemplo é executado com en-US como a cultura atual.The example is run with en-US as the current culture.

array<String^>^ formats = gcnew array<String^> {"C3", "D4", "e1", "E2", "F1", "G", "N1", 
                                                "P0", "X4", "0000.0000"};
Byte number = 240;
for each (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           
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           
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 parâmetro format pode ser uma cadeia de caracteres de formato numérico padrão ou personalizado.The format parameter can be either a standard or a custom numeric format string. 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.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Se format fornull ou uma cadeia de caracteres vazia (""), o valor de retorno será formatado com o especificador de formato numérico geral ("G").If format is null or an empty string (""), the return value is formatted with the general numeric format specifier ("G").

O valor de retorno dessa função é formatado usando o NumberFormatInfo objeto para a cultura de thread atual.The return value of this function is formatted using the NumberFormatInfo object for the thread current culture. Para obter informações sobre a cultura do thread atual, consulte Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame o Byte.ToString(String, IFormatProvider) método.To provide formatting information for cultures other than the current culture, call the Byte.ToString(String, IFormatProvider) method.

O .NET Framework fornece extenso suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Veja também

ToString() ToString() ToString() ToString()

Converte o valor do atual objeto Byte na representação de cadeia de caracteres equivalente.Converts the value of the current Byte object to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Retornos

A representação de cadeia de caracteres do valor deste objeto, que consiste em uma sequência de dígitos que variam de 0 a 9 sem zeros à esquerda.The string representation of the value of this object, which consists of a sequence of digits that range from 0 to 9 with no leading zeroes.

Exemplos

O exemplo a seguir exibe uma matriz de valores de byte.The following example displays an array of byte values. Observe que o ToString() método não é chamado explicitamente no exemplo.Note that the ToString() method is not called explicitly in the example. Em vez disso, ele é chamado implicitamente, devido ao uso do recurso de formatação composta .Instead, it is called implicitly, because of the use of the composite formatting feature.

array<Byte>^ bytes = gcnew array<Byte> {0, 1, 14, 168, 255};
for each (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
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
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 de retorno é formatado com o especificador de formato numérico geral ("G" NumberFormatInfo ) e o objeto para a cultura de thread atual.The return value is formatted with the general numeric format specifier ("G") and the NumberFormatInfo object for the thread current culture. Para definir a formatação da representação Byte de cadeia de caracteres do valor, ToString chame o método.To define the formatting of the Byte value's string representation, call the ToString method. Para definir os especificadores de formato e a cultura usada para criar a representação de cadeia Byte de caracteres de um ToString valor, chame o método.To define both the format specifiers and culture used to create the string representation of a Byte value, call the ToString method.

O .NET Framework fornece extenso suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Para obter informações sobre a cultura do thread atual, consulte Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

Aplica-se a