Ler em inglês

Compartilhar via


UInt32.ToString Método

Definição

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente.

Sobrecargas

ToString()

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente.

ToString(IFormatProvider)

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificadas.

ToString(String)

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando o formato especificado.

ToString(String, IFormatProvider)

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.

ToString()

Origem:
UInt32.cs
Origem:
UInt32.cs
Origem:
UInt32.cs

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente.

public override string ToString ();

Retornos

A representação da cadeia de caracteres do valor dessa instância, que consiste em uma sequência de dígitos que varia de 0 a 9, sem um sinal ou zeros à esquerda.

Exemplos

O exemplo a seguir exibe um valor UInt32 usando o método de ToString() padrão. Ele também exibe as representações de cadeia de caracteres do valor UInt32 resultante do uso de alguns especificadores de formato padrão. Os exemplos são exibidos usando as convenções de formatação da cultura en-US.

using System;

public class Example
{
   public static void Main()
   {
      uint value = 1632490;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());      
      Console.WriteLine();
      
      // Define an array of format specifiers.
      string[] formats = { "G", "C", "D", "F", "N", "X" };
      // Display value using the standard format specifiers.
      foreach (string format in formats)
         Console.WriteLine("{0} format specifier: {1,16}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       1632490
//       
//       G format specifier:          1632490
//       C format specifier:    $1,632,490.00
//       D format specifier:          1632490
//       F format specifier:       1632490.00
//       N format specifier:     1,632,490.00
//       X format specifier:           18E8EA

Comentários

O método ToString() formata um valor UInt32 no formato padrão ("G" ou geral) usando o objeto NumberFormatInfo da cultura atual. Se você quiser especificar um formato ou cultura diferente, use as outras sobrecargas do método ToString da seguinte maneira:

Para usar o formato Para cultura Usar 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)

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(IFormatProvider)

Origem:
UInt32.cs
Origem:
UInt32.cs
Origem:
UInt32.cs

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificadas.

public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider? provider);

Parâmetros

provider
IFormatProvider

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

Retornos

A representação de cadeia de caracteres do valor dessa instância, que consiste em uma sequência de dígitos que variam de 0 a 9, sem um sinal ou zeros à esquerda.

Implementações

Exemplos

O exemplo a seguir formata um valor inteiro com sinal de 16 bits usando vários provedores de formato, incluindo um para a cultura invariável. A saída do exemplo ilustra que a cadeia de caracteres formatada retornada pelo método ToString(IFormatProvider) é a mesma, independentemente do provedor de formato.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define an array of CultureInfo objects.
      CultureInfo[] ci = { new CultureInfo("en-US"), 
                           new CultureInfo("fr-FR"), 
                           CultureInfo.InvariantCulture }; 
      uint value = 1870924;
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        GetName(ci[0]), GetName(ci[1]), GetName(ci[2])); 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));   
   }

   private static string GetName(CultureInfo ci)
   {
      if (ci.Equals(CultureInfo.InvariantCulture))
         return "Invariant";
      else
         return ci.Name;         
   }
}
// The example displays the following output:
//             en-US          fr-FR      Invariant
//           1870924        1870924        1870924

Comentários

O método ToString(IFormatProvider) formata um valor UInt32 no formato padrão ("G" ou geral) usando o objeto NumberFormatInfo de uma cultura especificada. Se você quiser especificar um formato diferente ou a cultura atual, use as outras sobrecargas do método ToString, da seguinte maneira:

Para usar o formato Para cultura Usar 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 parâmetro provider é uma implementação IFormatProvider. Seu método GetFormat retorna um objeto NumberFormatInfo que fornece informações de formatação específicas da cultura. No entanto, nenhuma das propriedades do NumberFormatInfo são usadas ao formatar com o especificador de formato numérico geral ("G").

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

Origem:
UInt32.cs
Origem:
UInt32.cs
Origem:
UInt32.cs

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando o formato especificado.

public string ToString (string format);
public string ToString (string? format);

Parâmetros

format
String

Uma cadeia de caracteres de formato numérico.

Retornos

A representação da cadeia de caracteres do valor dessa instância, conforme especificado por format.

Exceções

O parâmetro format é inválido.

Exemplos

O exemplo a seguir exibe um valor inteiro sem sinal de 32 bits usando cada cadeia de caracteres de formato padrão e algumas cadeias de caracteres de formato personalizado.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      uint value = 2179608;
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "000000.0", "#.0", 
                              "00000000;(0);**Zero**" };
      
      foreach (string specifier in specifiers)
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
   }
}
// The example displays the following output:
//       G: 2179608
//       C: $2,179,608.00
//       D3: 2179608
//       E2: 2.18E+006
//       e3: 2.180e+006
//       F: 2179608.00
//       N: 2,179,608.00
//       P: 217,960,800.00 %
//       X: 214218
//       000000.0: 2179608.0
//       #.0: 2179608.0
//       00000000;(0);**Zero**: 02179608

Comentários

O método ToString(String) formata um valor UInt32 em um formato especificado usando um objeto NumberFormatInfo que representa as convenções da cultura atual. Se você quiser usar o formato padrão ("G" ou geral) ou especificar uma cultura diferente, use as outras sobrecargas do método ToString, da seguinte maneira:

Para usar o formato Para cultura Usar 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 parâmetro format pode ser qualquer cadeias de caracteres de formato numérico padrão válidasou qualquer combinação de cadeias de caracteres de formato numérico personalizado . Se format for igual a String.Empty ou for null, o valor retornado do objeto UInt32 atual será formatado com o especificador de formato geral ("G"). Se format for qualquer outro valor, o método gerará um FormatException.

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

O formato da cadeia de caracteres retornada é determinado pelo objeto NumberFormatInfo para a cultura atual. Dependendo do parâmetro format, esse objeto controla símbolos como o separador de grupo e o símbolo de ponto decimal na cadeia de caracteres de saída. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame a sobrecarga de ToString(String, IFormatProvider).

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

Origem:
UInt32.cs
Origem:
UInt32.cs
Origem:
UInt32.cs

Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.

public string ToString (string format, IFormatProvider provider);
public string ToString (string? format, IFormatProvider? provider);

Parâmetros

format
String

Uma cadeia de caracteres de formato numérico.

provider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura sobre essa instância.

Retornos

A representação de cadeia de caracteres do valor dessa instância, conforme especificado por format e provider.

Implementações

Exceções

O parâmetro format é inválido.

Exemplos

O exemplo a seguir exibe um valor inteiro sem sinal de 32 bits usando os especificadores de formato numérico padrão e vários objetos CultureInfo específicos.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define cultures whose formatting conventions are to be used.
      CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"), 
                                 CultureInfo.CreateSpecificCulture("fr-FR"), 
                                 CultureInfo.CreateSpecificCulture("es-ES") };
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      uint value = 2222402;
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}",  
                              specifier, culture.Name, 
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:            2222402
//        G format using fr-FR culture:            2222402
//        G format using es-ES culture:            2222402
//       
//        C format using en-US culture:      $2,222,402.00
//        C format using fr-FR culture:     2 222 402,00 €
//        C format using es-ES culture:     2.222.402,00 €
//       
//       D4 format using en-US culture:            2222402
//       D4 format using fr-FR culture:            2222402
//       D4 format using es-ES culture:            2222402
//       
//       E2 format using en-US culture:          2.22E+006
//       E2 format using fr-FR culture:          2,22E+006
//       E2 format using es-ES culture:          2,22E+006
//       
//        F format using en-US culture:         2222402.00
//        F format using fr-FR culture:         2222402,00
//        F format using es-ES culture:         2222402,00
//       
//        N format using en-US culture:       2,222,402.00
//        N format using fr-FR culture:       2 222 402,00
//        N format using es-ES culture:       2.222.402,00
//       
//        P format using en-US culture:   222,240,200.00 %
//        P format using fr-FR culture:   222 240 200,00 %
//        P format using es-ES culture:   222.240.200,00 %
//       
//       X2 format using en-US culture:             21E942
//       X2 format using fr-FR culture:             21E942
//       X2 format using es-ES culture:             21E942

Comentários

O método ToString(String, IFormatProvider) formata um valor UInt32 em um formato especificado usando o objeto NumberFormatInfo de uma cultura especificada. Se você quiser usar as configurações de formato ou cultura padrão, use as outras sobrecargas do método ToString da seguinte maneira:

Para usar o formato Para cultura Usar 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 parâmetro format pode ser qualquer cadeias de caracteres de formato numérico padrão válidasou qualquer combinação de cadeias de caracteres de formato numérico personalizado . Se format for igual a String.Empty ou for null, o valor retornado do objeto UInt32 atual será formatado com o especificador de formato geral ("G"). Se format for qualquer outro valor, o método gerará um FormatException.

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

O parâmetro provider é uma implementação IFormatProvider. Seu método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas da cultura sobre o formato da cadeia de caracteres retornada por esse método. Quando o método ToString(String, IFormatProvider) é invocado, ele chama o método IFormatProvider.GetFormat do parâmetro provider e passa um objeto Type que representa o tipo NumberFormatInfo. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações para formatar o valor UInt32 atual, como o símbolo separador de grupo ou o símbolo de ponto decimal. Há três maneiras de usar o parâmetro provider para fornecer informações de formatação ao método ToString(String, IFormatProvider):

  • Você pode passar um objeto CultureInfo que representa a cultura que fornece informações de formatação. Seu método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação numérica para essa cultura.

  • Você pode passar o objeto NumberFormatInfo real que fornece informações de formatação numérica. (Sua implementação de GetFormat apenas retorna a si mesma.)

  • Você pode passar um objeto personalizado que implementa IFormatProvider. Seu método GetFormat cria uma instância e retorna o objeto NumberFormatInfo que fornece informações de formatação.

Se provider for null, a formatação da cadeia de caracteres retornada será baseada no objeto NumberFormatInfo da cultura atual.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0