Int16.ToString Int16.ToString Int16.ToString Int16.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 formatação específicas da cultura.Converts the numeric value of this instance 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 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:
 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 IFormatProvider que fornece informações de formatação específicas à cultura.An IFormatProvider that supplies culture-specific formatting information.

Retornos

A representação da cadeia de caracteres do valor dessa instância conforme especificado por provider.The string representation of the value of this instance as specified by provider.

Implementações

Exemplos

O exemplo a seguir itera uma matriz de Int16 valores e exibe cada um deles no console chamando o método com Int16.ToString(IFormatProvider) provedores de formato diferentes.The following example iterates an array of Int16 values and displays each of them to the console by calling the Int16.ToString(IFormatProvider) method with different format providers. Devido à formatação simples definida pelo especificador de formato "G" padrão, as cadeias de caracteres formatadas produzidas para cada Int16 valor são idênticas, independentemente do valor provider do parâmetro.Because of the simple formatting defined by the default "G" format specifier, the formatted strings produced for each Int16 value are identical regardless of the value of the provider parameter.

short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("de-de"), 
                           new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0, 6} ({1})     ", 
                    int16Value.ToString(provider), 
                    provider.Name);
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
//            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
//        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
//        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)      
Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
   For Each provider As CultureInfo In providers
      Console.Write("{0, 6} ({1})     ", _
                    int16Value.ToString(provider), _
                    provider.Name)
   Next                     
   Console.WriteLine()
Next 
' The example displays the following output to the console:
'       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
'            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
'        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
'        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)      

Comentários

O ToString(IFormatProvider) método formata um Int16 valor no formato padrão ("G" ou geral) usando o NumberFormatInfo objeto de uma cultura especificada.The ToString(IFormatProvider) method formats an Int16 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 culturaFor culture Usar a sobrecargaUse the overload
Formato padrão ("G")Default ("G") format Cultura padrão (atual)Default (current) culture ToString()
Um formato específicoA specific format Cultura padrão (atual)Default (current) culture ToString(String)
Um formato específicoA specific format Uma cultura específicaA specific culture ToString(String, IFormatProvider)

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 cujo método IFormatProvider.GetFormat retorna um objeto NumberFormatInfo.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Normalmente, provider é um objeto NumberFormatInfo ou um objeto CultureInfo.Typically, provider is a NumberFormatInfo object or a CultureInfo object. O NumberFormatInfo objeto fornece informações específicas de cultura sobre o formato da cadeia de caracteres retornada por esse método.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. Se provider NumberFormatInfo for null, essa instância será formatada com o objeto para a cultura atual.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

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 formatação específicas da cultura.Converts the numeric value of this instance 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 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

Exemplos

O exemplo a seguir exibe Int16 um valor usando cada uma das cadeias de caracteres de formato padrão com suporte em quatro culturas diferentes.The following example displays an Int16 value using each of the supported standard format strings in four different cultures.

Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1", 
                    "P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("de-de"), 
                           new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1], 
                  providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
   // Display the value for each provider on the same line.
   Console.Write("{0,-12}", format);
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0,12}  ", 
                    value.ToString(format, provider)); 
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//                       en-US         fr-FR         de-DE         es-ES
//    
//    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
//    D6                014603        014603        014603        014603  
//    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
//    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
//    F1               14603.0       14603,0       14603,0       14603,0  
//    G                  14603         14603         14603         14603  
//    N1              14,603.0      14 603,0      14.603,0      14.603,0  
//    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
//    X4                  390B          390B          390B          390B  
//    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
//    ##000.0          14603.0       14603,0       14603,0       14603,0  
Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
                  providers(2), providers(3))
Console.WriteLine()                        
' Display a value using each format string.
For Each format As String In formats
   ' Display the value for each provider on the same line.
   Console.Write("{0,-12}", format)
   For Each provider As CultureInfo In providers
      Console.Write("{0,12}  ", _
                    value.ToString(format, provider)) 
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'                       en-US         fr-FR         de-DE         es-ES
'    
'    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
'    D6                014603        014603        014603        014603  
'    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
'    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
'    F1               14603.0       14603,0       14603,0       14603,0  
'    G                  14603         14603         14603         14603  
'    N1              14,603.0      14 603,0      14.603,0      14.603,0  
'    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
'    X4                  390B          390B          390B          390B  
'    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
'    ##000.0          14603.0       14603,0       14603,0       14603,0  

Comentários

O ToString(String, IFormatProvider) método formata um Int16 valor em um formato especificado usando o NumberFormatInfo objeto de uma cultura especificada.The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object of a specified culture. Se você quiser usar o formato padrão ou as configurações de cultura, use as outras sobrecargas ToString do 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 culturaFor culture Usar a sobrecargaUse the overload
Formato padrão ("G")Default ("G") format Cultura padrão (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 Cultura padrão (atual)Default (current) culture ToString(String)

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 (""), a cadeia de caracteres retornada por esse método será formatada com o especificador de formato numérico geral ("G").If format is null or an empty string (""), the string returned by this method is formatted with the general numeric format specifier ("G").

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 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 NumberFormatInfo for null, ou um objeto não puder ser obtido providerde, o valor de retorno será formatado NumberFormatInfo com o para a cultura atual.If provider is null, or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted with the NumberFormatInfo for 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.

Exemplos

O exemplo a seguir inicializa Int16 dois valores e os exibe para o console usando cada uma das cadeias de caracteres de formato padrão com suporte e várias cadeias de caracteres de formato personalizado.The following example initializes two Int16 values and displays them to the console using each of the supported standard format strings and several custom format strings. O exemplo é executado com en-US como a cultura atual.The example is run with en-US as the current culture.

Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1", 
                    "P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}",  
                     format, 
                     values[0].ToString(format), 
                     values[1].ToString(format));
}                                                               
// The example displays the following output to the console:
//    'C4' format specifier:    ($23,805.0000)        $32,194.0000
//    'D6' format specifier:           -023805              032194
//    'e1' format specifier:         -2.4e+004            3.2e+004
//    'E2' format specifier:        -2.38E+004           3.22E+004
//    'F1' format specifier:          -23805.0             32194.0
//    ' G' format specifier:            -23805               32194
//    'N1' format specifier:         -23,805.0            32,194.0
//    'P0' format specifier:      -2,380,500 %         3,219,400 %
//    'X4' format specifier:              A303                7DC2
//    '000000.0000' format specifier:      -023805.0000         032194.0000
//    '##000.0' format specifier:          -23805.0             32194.0      
Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}", _ 
                     format, _
                     values(0).ToString(format), _
                     values(1).ToString(format))
Next                                                               
' The example displays the following output to the console:
'    'C4' format specifier:    ($23,805.0000)        $32,194.0000
'    'D6' format specifier:           -023805              032194
'    'e1' format specifier:         -2.4e+004            3.2e+004
'    'E2' format specifier:        -2.38E+004           3.22E+004
'    'F1' format specifier:          -23805.0             32194.0
'    ' G' format specifier:            -23805               32194
'    'N1' format specifier:         -23,805.0            32,194.0
'    'P0' format specifier:      -2,380,500 %         3,219,400 %
'    'X4' format specifier:              A303                7DC2
'    '000000.0000' format specifier:      -023805.0000         032194.0000
'    '##000.0' format specifier:          -23805.0             32194.0      

Comentários

O ToString(String) método formata um Int16 valor em um formato especificado usando um NumberFormatInfo objeto que representa as convenções da cultura atual.The ToString(String) method formats an Int16 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Se você quiser usar o formato padrão ("G" ou geral) ou especificar uma cultura diferente, use as outras sobrecargas do 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 culturaFor culture Usar a sobrecargaUse the overload
Formato padrão ("G")Default ("G") format Cultura padrão (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 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 dessa instância será formatado com o especificador de formato numérico geral ("G").If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier ("G").

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 valor de retorno dessa instância é formatado com o NumberFormatInfo para a cultura atual.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

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 da cadeia de caracteres do valor dessa instância, consistindo em um sinal de subtração se o valor for negativo e uma sequência de dígitos, variando de 0 a 9 sem zeros à esquerda.The string representation of the value of this instance, consisting of a minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Exemplos

O exemplo a seguir usa ToString() o método para exibir uma matriz Int16 de valores para o console.The following example uses the ToString() method to display an array of Int16 values to the console.

short[] numbers = {0, 14624, 13982, short.MaxValue, 
                   short.MinValue, -16667};
foreach (short number in numbers)
{
   Console.WriteLine(number.ToString());
}            
// The example displays the following output to the console:
//       0
//       14624
//       13982
//       32767
//       -32768
//       -16667                             
Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
                         Short.MinValue, -16667}
For Each number As Short In numbers
   Console.WriteLine(number.ToString())
Next        
' The example displays the following output to the console:
'       0
'       14624
'       13982
'       32767
'       -32768
'       -16667                             

Comentários

O ToString() método formata um Int16 valor no formato padrão ("G" ou geral) usando o NumberFormatInfo objeto da cultura atual.The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Se você quiser especificar um formato ou cultura diferente, 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 culturaFor culture Usar 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 Cultura padrão (atual)Default (current) culture ToString(String)
Um formato específicoA specific format Uma cultura específicaA specific culture ToString(String, IFormatProvider)

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

Aplica-se a