Int16.ToString Método

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Converte o valor numérico desta instância para a sua representação equivalente em cadeias.

Sobrecargas

Name	Description
ToString(IFormatProvider)	Converte o valor numérico desta instância para a sua representação equivalente de cadeias usando a informação de formato específica da cultura especificada.
ToString()	Converte o valor numérico desta instância para a sua representação equivalente em cadeias.
ToString(String)	Converte o valor numérico desta instância para a sua representação equivalente em cadeias, usando o formato especificado.
ToString(String, IFormatProvider)	Converte o valor numérico desta instância para a sua representação equivalente de cadeias usando o formato especificado e a informação de formatação específica da cultura.

ToString(IFormatProvider)

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Converte o valor numérico desta instância para a sua representação equivalente de cadeias usando a informação de formato específica da cultura especificada.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString(IFormatProvider provider);

public string ToString(IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parâmetros

provider: IFormatProvider

E IFormatProvider que forneça informação de formatação específica para cada cultura.

Devoluções

String

A representação da cadeia do valor desta instância conforme especificado por provider.

Implementações

ToString(IFormatProvider)

Exemplos

O exemplo seguinte itera um array de Int16 valores e apresenta cada um deles à consola, chamando o Int16.ToString(IFormatProvider) método com diferentes fornecedores de formato. Devido à formatação simples definida pelo especificador de formato padrão "G", as strings formatadas produzidas para cada Int16 valor são idênticas independentemente do valor do provider parâmetro.

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)

let numbers = [ -23092s; 0s; 14894s; Int16.MaxValue ]
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "de-de"
      CultureInfo "es-es" ]

for int16Value in numbers do
    for provider in providers do
        printf $"{int16Value.ToString provider, 6} ({provider.Name})     "
                    
    printfn ""

// 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)

Observações

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

Para usar o formato	Pela cultura	Usa 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 .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:

Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre formatação, consulte Tipos de Formatação.

O provider parâmetro é uma IFormatProvider implementação cujo IFormatProvider.GetFormat método devolve um NumberFormatInfo objeto. Normalmente, provider é um NumberFormatInfo objeto ou um CultureInfo objeto. O NumberFormatInfo objeto fornece informação específica da cultura sobre o formato da cadeia devolvida por este método. Se provider for null, esta instância é formatada com o NumberFormatInfo objeto da cultura atual.

Ver também

Aplica-se a

ToString()

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Converte o valor numérico desta instância para a sua representação equivalente em cadeias.

public:
 override System::String ^ ToString();

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Devoluções

String

A representação da cadeia do valor desta instância, consistindo num sinal menos se o valor for negativo, e numa sequência de dígitos de 0 a 9 sem zeros à esquerda.

Exemplos

O exemplo seguinte utiliza o ToString() método para mostrar um array de Int16 valores na consola.

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

let numbers = [ 0s; 14624s; 13982s; Int16.MaxValue; Int16.MinValue; -16667s ]

for number in numbers do
    printfn $"{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

Observações

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

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

O .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:

Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre formatação, consulte Tipos de Formatação.

Ver também

Aplica-se a

ToString(String)

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Converte o valor numérico desta instância para a sua representação equivalente em cadeias, usando o formato especificado.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString(string format);

public string ToString(string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Parâmetros

format: String

Uma cadeia de formato numérico.

Devoluções

String

A representação da cadeia do valor desta instância conforme especificado por format.

Exemplos

O exemplo seguinte inicializa dois Int16 valores e apresenta-os na consola usando cada uma das strings de formato padrão suportadas e várias strings de formato personalizadas. O exemplo é gerido com en-US como cultura atual.

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

let values = [| -23805s; 32194s |]
let formats = 
    [ "C4"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
      "P0"; "X4"; "000000.0000"; "##000.0" ]
for format in formats do
    printfn $"'{format,2}' format specifier: {values[0].ToString format,17}   {values[1].ToString format,17}"

// 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

Observações

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

Para usar o formato	Pela cultura	Usa 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 format parâmetro pode ser uma cadeia de formato padrão ou numérica personalizada. Todas as cadeias de formato numérico padrão, exceto "R" (ou "r"), são suportadas, assim como todos os caracteres numéricos personalizados. Se format for null ou uma cadeia vazia, o valor de retorno desta instância é formatado com o especificador de formato numérico geral ("G").

O .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:

Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre formatação, consulte Tipos de Formatação.

O valor de retorno desta instância está formatado com o NumberFormatInfo para a cultura atual.

Ver também

Parse(String)
String
Tipos de Formatação em .NET
Standard Numeric Format Strings (Cadeias de Formato Numérico Padrão)
Cadeias de caracteres de formato numérico personalizado
Como: Preencher um número com zeros à esquerda

Aplica-se a

ToString(String, IFormatProvider)

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Origem:: Int16.cs

Converte o valor numérico desta instância para a sua representação equivalente de cadeias usando o formato especificado e a informação de formatação específica da cultura.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString(string format, IFormatProvider provider);

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

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Parâmetros

format: String

Uma cadeia de formato numérico.

provider: IFormatProvider

Um objeto que fornece informação de formatação específica para cada cultura.

Devoluções

String

A representação da cadeia do valor desta instância conforme especificado por format e provider.

Implementações

ToString(String, IFormatProvider)

Exemplos

O exemplo seguinte apresenta um Int16 valor usando cada uma das cadeias de formato padrão suportadas em quatro culturas diferentes.

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

 let value = 14603
 let formats =
     [ "C"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
       "P0"; "X4"; "000000.0000"; "##000.0" ]
 let providers = 
     [ CultureInfo "en-us"
       CultureInfo "fr-fr"
       CultureInfo "de-de"
       CultureInfo "es-es" ]
 // Display header.
 printfn $"{providers[0],24}{providers[1],14}{providers[2],14}{providers[3],14}\n"
 
 // Display a value using each format string.
 for format in formats do
     // Display the value for each provider on the same line.
     printf $"{format,-12}"
     for provider in providers do
         printf $"{value.ToString(format, provider),12}  "
     printfn ""

// 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

Observações

O ToString(String, IFormatProvider) método formata um Int16 valor num formato especificado usando o NumberFormatInfo objeto de uma cultura especificada. Se quiser usar definições de formato ou cultura por defeito, use as outras sobrecargas do ToString método, da seguinte forma:

Para usar o formato	Pela cultura	Usa 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 format parâmetro pode ser uma cadeia de formato padrão ou numérica personalizada. Todas as cadeias de formato numérico padrão, exceto "R" (ou "r"), são suportadas, assim como todos os caracteres numéricos personalizados. Se format for null ou uma cadeia vazia (""), a cadeia devolvida por este método é formatada com o especificador de formato numérico geral ("G").

O .NET oferece um suporte extenso de formatação, que é descrito com mais detalhe nos seguintes tópicos de formatação:

Para mais informações sobre especificadores de formato numérico, consulte Cadeias de Formato Numérico Padrão e Cadeias de Formato Numérico Personalizado.
Para mais informações sobre formatação, consulte Tipos de Formatação.

O provider parâmetro é uma IFormatProvider implementação. O seu GetFormat método devolve um NumberFormatInfo objeto que fornece informação específica da cultura sobre o formato da cadeia que é devolvida por este método. O objeto que implementa IFormatProvider pode ser qualquer um dos seguintes:

Um CultureInfo objeto que representa a cultura cujas regras de formatação devem ser usadas.
Um NumberFormatInfo objeto que contenha informação numérica específica de formatação para esse valor.
Um objeto personalizado que implementa IFormatProvider.

Se provider for null, ou um NumberFormatInfo objeto não puder ser obtido a partir de provider, o valor de retorno é formatado com para NumberFormatInfo a cultura atual.

Ver também

Aplica-se a

Comentários

Esta página foi útil?