UInt16.ToString UInt16.ToString UInt16.ToString UInt16.ToString Method

Definição

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente.Converts the numeric value of this instance to its equivalent string representation.

Sobrecargas

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

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificada.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura especificada.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

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

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando o formato especificado.Converts the numeric value of this instance to its equivalent string representation using the specified format.

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

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente.Converts the numeric value of this instance to its equivalent string representation.

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

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificada.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public:
 virtual 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 dessa instância, que consiste em uma sequência de dígitos de 0 a 9 sem sinal nem zeros à esquerda.The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

Implementações

Exemplos

O exemplo a seguir formata um valor inteiro com sinal de 16 bits por meio de vários provedores de formato, incluindo uma para a cultura invariável.The following example formats a 16-bit signed integer value by using several format providers, including one for the invariant culture. A saída do exemplo ilustra que a cadeia de caracteres formatada retornados pelo ToString(IFormatProvider) método é o mesmo, independentemente do provedor de formato.The output from the example illustrates that the formatted string returned by the ToString(IFormatProvider) method is the same regardless of the format provider.

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 }; 
      UInt16 value = 18924;
      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
//          18924          18924          18924
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define an array of CultureInfo objects.
      Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
                                  New CultureInfo("fr-FR"), _
                                  CultureInfo.InvariantCulture } 
      Dim value As UInt16 = 18924
      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)))            
      
   End Sub
   
   Private Function GetName(ci As CultureInfo) As String
      If ci.Equals(CultureInfo.InvariantCulture) Then
         Return "Invariant"
      Else
         Return ci.Name
      End If   
   End Function
End Module
' The example displays the following output:
'         en-US          fr-FR      Invariant
'         18924          18924          18924

Comentários

O ToString(IFormatProvider) formatos do método uma UInt16 o valor padrão ("G" ou geral) formato usando o NumberFormatInfo objeto de uma cultura específica.The ToString(IFormatProvider) method formats a UInt16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Se você quiser especificar um formato diferente ou a cultura atual, use as outras sobrecargas do ToString método, da seguinte maneira:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Para usar o formatoTo use format Para a culturaFor culture Use a sobrecargaUse the overload
Formato padrão ("G")Default ("G") format Padrão de cultura (atual)Default (current) culture ToString()
Um formato específicoA specific format Padrão de cultura (atual)Default (current) culture ToString(String)
Um formato específicoA specific format Uma cultura específicaA specific culture ToString(String, IFormatProvider)

O parâmetro provider é uma implementação de IFormatProvider.The provider parameter is an IFormatProvider implementation. Sua GetFormat método retorna um NumberFormatInfo objeto que fornece informações de formatação específicas da cultura.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. No entanto, nenhuma das propriedades do NumberFormatInfo são usados quando a formatação com o especificador de formato numérico geral ("G").However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

Veja também

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

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura especificada.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format 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 de formato numérico.A 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 da cadeia de caracteres do valor dessa instância conforme especificado por format e provider.The string representation of the value of this instance, as specified by format and provider.

Implementações

Exceções

format é inválido.format is invalid.

Exemplos

O exemplo a seguir exibe um valor inteiro sem sinal de 16 bits, usando os especificadores de formato numérico padrão e um número de determinado CultureInfo objetos.The following example displays a 16-bit unsigned integer value by using the standard numeric format specifiers and a number of specific CultureInfo objects.

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"}; 
      ushort value = 22042;
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 16}",  
                              specifier, culture.Name, 
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:            22042
//        G format using fr-FR culture:            22042
//        G format using es-ES culture:            22042
//       
//        C format using en-US culture:       $22,042.00
//        C format using fr-FR culture:      22 042,00 €
//        C format using es-ES culture:      22.042,00 €
//       
//       D4 format using en-US culture:            22042
//       D4 format using fr-FR culture:            22042
//       D4 format using es-ES culture:            22042
//       
//       E2 format using en-US culture:        2.20E+004
//       E2 format using fr-FR culture:        2,20E+004
//       E2 format using es-ES culture:        2,20E+004
//       
//        F format using en-US culture:         22042.00
//        F format using fr-FR culture:         22042,00
//        F format using es-ES culture:         22042,00
//       
//        N format using en-US culture:        22,042.00
//        N format using fr-FR culture:        22 042,00
//        N format using es-ES culture:        22.042,00
//       
//        P format using en-US culture:   2,204,200.00 %
//        P format using fr-FR culture:   2 204 200,00 %
//        P format using es-ES culture:   2.204.200,00 %
//       
//       X2 format using en-US culture:             561A
//       X2 format using fr-FR culture:             561A
//       X2 format using es-ES culture:             561A
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define cultures whose formatting conventions are to be used.
      Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
                                       CultureInfo.CreateSpecificCulture("fr-FR"), _
                                       CultureInfo.CreateSpecificCulture("es-ES") }
      Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"} 
      Dim value As UShort = 22042
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 16}", _ 
                              specifier, culture.Name, _
                              value.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'        G format using en-US culture:            22042
'        G format using fr-FR culture:            22042
'        G format using es-ES culture:            22042
'       
'        C format using en-US culture:       $22,042.00
'        C format using fr-FR culture:      22 042,00 €
'        C format using es-ES culture:      22.042,00 €
'       
'       D4 format using en-US culture:            22042
'       D4 format using fr-FR culture:            22042
'       D4 format using es-ES culture:            22042
'       
'       E2 format using en-US culture:        2.20E+004
'       E2 format using fr-FR culture:        2,20E+004
'       E2 format using es-ES culture:        2,20E+004
'       
'        F format using en-US culture:         22042.00
'        F format using fr-FR culture:         22042,00
'        F format using es-ES culture:         22042,00
'       
'        N format using en-US culture:        22,042.00
'        N format using fr-FR culture:        22 042,00
'        N format using es-ES culture:        22.042,00
'       
'        P format using en-US culture:   2,204,200.00 %
'        P format using fr-FR culture:   2 204 200,00 %
'        P format using es-ES culture:   2.204.200,00 %
'       
'       X2 format using en-US culture:             561A
'       X2 format using fr-FR culture:             561A
'       X2 format using es-ES culture:             561A

Comentários

O ToString(String, IFormatProvider) formatos do método uma UInt16 valor em um formato especificado usando o NumberFormatInfo objeto de uma cultura específica.The ToString(String, IFormatProvider) method formats a UInt16 value in a specified format by using the NumberFormatInfo object of a specified culture. Se você quiser usar as configurações de cultura ou formato de padrão, use as outras sobrecargas do ToString método, da seguinte maneira:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Para usar o formatoTo use format Para a culturaFor culture Use a sobrecargaUse the overload
Formato padrão ("G")Default ("G") format Padrão de cultura (atual)Default (current) culture ToString()
Formato padrão ("G")Default ("G") format Uma cultura específicaA specific culture ToString(IFormatProvider)
Um formato específicoA specific format Padrão de cultura (atual)Default (current) culture ToString(String)

O format parâmetro pode ser qualquer cadeias de caracteres de formato numérico padrão, ou qualquer combinação às cadeias de caracteres de formato numérico personalizado.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Se format é igual a String.Empty ou está null, o valor de retorno do atual UInt16 objeto é formatado com o especificador de formato geral ("G").If format is equal to String.Empty or is null, the return value of the current UInt16 object is formatted with the general format specifier ("G"). Caso format tenha qualquer outro valor, o método lança um FormatException.If format is any other value, the method throws a FormatException.

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:

O parâmetro provider é uma implementação de IFormatProvider.The provider parameter is an IFormatProvider implementation. O método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas de cultura sobre o formato da cadeia de caracteres retornada por esse método.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Quando o ToString(String, IFormatProvider) método é invocado, ele chama o provider do parâmetro IFormatProvider.GetFormat método e passa um Type objeto que representa o NumberFormatInfo tipo.When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's IFormatProvider.GetFormat method and passes it a Type object that represents the NumberFormatInfo type. O GetFormat método retorna, em seguida, o NumberFormatInfo objeto que fornece informações de formatação atual UInt16 valor, como o símbolo de separador de grupo ou o símbolo da vírgula decimal.The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the current UInt16 value, such as the group separator symbol or the decimal point symbol. Há três maneiras de usar o provider parâmetro para fornecer informações de formatação para o ToString(String, IFormatProvider) método:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • É possível passar um objeto CultureInfo que representa a cultura que fornece informações de formatação.You can pass a CultureInfo object that represents the culture that supplies formatting information. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação numérica para essa cultura.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • É possível passar o objeto real NumberFormatInfo que fornece informações de formatação numérica.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Sua implementação de GetFormat retorna apenas ele próprio.)(Its implementation of GetFormat just returns itself.)

  • É possível passar um objeto personalizado que implementa IFormatProvider.You can pass a custom object that implements IFormatProvider. O método GetFormat cria uma instância e retorna o objeto NumberFormatInfo que fornece informações de formatação.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Caso provider seja null, a formatação da cadeia de caracteres retornada baseia-se no objeto NumberFormatInfo da cultura atual.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Veja também

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

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente usando o formato especificado.Converts the numeric value of this instance 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 da cadeia de caracteres do valor dessa instância conforme especificado por format.The string representation of the value of this instance as specified by format.

Exceções

O parâmetro format é inválido.The format parameter is invalid.

Exemplos

O exemplo a seguir exibe um valor inteiro sem sinal de 16 bits, usando cada cadeia de caracteres de formato padrão e algumas cadeias de caracteres de formato personalizado.The following example displays a 16-bit unsigned integer value by using each standard format string and some custom format strings.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      ushort value = 21708;
      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: 21708
//       C: $21,708.00
//       D3: 21708
//       E2: 2.17E+004
//       e3: 2.171e+004
//       F: 21708.00
//       N: 21,708.00
//       P: 2,170,800.00 %
//       X: 54CC
//       000000.0: 021708.0
//       #.0: 21708.0
//       00000000;(0);**Zero**: 00021708
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UShort = 21708 
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "000000.0", "#.0", _
                                     "00000000;(0);**Zero**" }
      
      For Each specifier As String In specifiers
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
      Next
   End Sub
End Module
' The example displays the following output:
'       G: 21708
'       C: $21,708.00
'       D3: 21708
'       E2: 2.17E+004
'       e3: 2.171e+004
'       F: 21708.00
'       N: 21,708.00
'       P: 2,170,800.00 %
'       X: 54CC
'       000000.0: 021708.0
'       #.0: 21708.0
'       00000000;(0);**Zero**: 00021708

Comentários

O ToString(String) formatos do método uma UInt16 valor em um formato especificado usando um NumberFormatInfo objeto que representa as convenções da cultura atual.The ToString(String) method formats a UInt16 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Se você quiser usar o padrão ("G" ou geral) formatar ou especificar uma cultura diferente, use as outras sobrecargas de ToString método, da seguinte maneira:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

Para usar o formatoTo use format Para a culturaFor culture Use a sobrecargaUse the overload
Formato padrão ("G")Default ("G") format Padrão de cultura (atual)Default (current) culture ToString()
Formato padrão ("G")Default ("G") format Uma cultura específicaA specific culture ToString(IFormatProvider)
Um formato específicoA specific format Uma cultura específicaA specific culture ToString(String, IFormatProvider)

O format parâmetro pode ser qualquer especificador de formato numérico padrão, ou qualquer combinação especificadores de formato numérico personalizado.The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. Se format é igual a String.Empty ou está null, o valor de retorno do atual UInt16 objeto é formatado com o especificador de formato geral ("G").If format is equal to String.Empty or is null, the return value of the current UInt16 object is formatted with the general format specifier ("G"). Caso format tenha qualquer outro valor, o método lança um FormatException.If format is any other value, the method throws a FormatException.

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:

O formato da cadeia de caracteres retornada é determinado pelo objeto NumberFormatInfo para a cultura atual.The format of the returned string is determined by the NumberFormatInfo object for the current culture. Dependendo do format parâmetro, esse objeto controla símbolos como o separador de grupo e o símbolo da vírgula decimal na cadeia de saída.Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame o ToString(String, IFormatProvider) de sobrecarga.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Veja também

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

Converte o valor numérico dessa instância na representação da cadeia de caracteres equivalente.Converts the numeric value of this instance 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 dessa instância, que consiste em uma sequência de dígitos de 0 a 9 sem sinal nem zeros à esquerda.The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

Exemplos

O exemplo a seguir exibe uma UInt16 valor, usando o padrão ToString() método.The following example displays a UInt16 value by using the default ToString() method. Ele também exibe as representações de cadeia de caracteres da UInt16 valor resultante do uso de alguns especificadores de formato padrão.It also displays the string representations of the UInt16 value that results from using some standard format specifiers. Os exemplos são exibidos usando-se as convenções de formatação da cultura en-US.The examples are displayed using the formatting conventions of the en-US culture.

using System;

public class Example
{
   public static void Main()
   {
      ushort value = 16324;
      // 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,12}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       16324
//
//       G format specifier:        16324
//       C format specifier:   $16,324.00
//       D format specifier:        16324
//       F format specifier:     16324.00
//       N format specifier:    16,324.00
//       X format specifier:         3FC4
Module Example
   Public Sub Main()
      Dim value As UInt16 = 16324
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            
      Console.WriteLine()
      
      ' Define an array of format specifiers.
      Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
      ' Display value using the standard format specifiers.
      For Each format As String In formats
         Console.WriteLine("{0} format specifier: {1,12}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' The example displays the following output:
'       16324
'       
'       G format specifier:        16324
'       C format specifier:   $16,324.00
'       D format specifier:        16324
'       F format specifier:     16324.00
'       N format specifier:    16,324.00
'       X format specifier:         3FC4

Comentários

O ToString() formatos do método uma UInt16 o valor padrão ("G" ou geral) formato usando o NumberFormatInfo objeto da cultura atual.The ToString() method formats a UInt16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Se você quiser especificar um formato diferente ou uma cultura, use as outras sobrecargas do ToString método, da seguinte maneira:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Para usar o formatoTo use format Para a culturaFor culture Use a sobrecargaUse the overload
Formato padrão ("G")Default ("G") format Uma cultura específicaA specific culture ToString(IFormatProvider)
Um formato específicoA specific format Padrão de cultura (atual)Default (current) culture ToString(String)
Um formato específicoA specific format Uma cultura específicaA specific culture ToString(String, IFormatProvider)
Veja também

Aplica-se a