Int32.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 específica de formato da cultura.

ToString(IFormatProvider)

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.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

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 provider.

Implementações

ToString(IFormatProvider)

Exemplos

O exemplo seguinte apresenta a representação de cadeias de um Int32 valor usando CultureInfo objetos que representam várias culturas diferentes.

int value = -16325;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325
//       -16325
//       -16325

let value = -16325
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""
// This example displays the following output to the console:
//       -16325
//       -16325
//       -16325

Dim value As Integer = -16325
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
'       -16325
'       -16325
'       -16325

Observações

O ToString(IFormatProvider) método formata um Int32 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 provider parâmetro é um objeto que implementa a IFormatProvider interface. 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 e cujo GetFormat método devolve um NumberFormatInfo objeto que fornece informação de formatação.

Se provider for ou um null objeto não puder ser obtido a partir de NumberFormatInfo, o valor de retorno é formatado usando o provider objeto para a cultura corrente NumberFormatInfo de threads. Para informações sobre a cultura atual do tópico, veja Thread.CurrentCulture.

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

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.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 negativo se o valor for negativo, e numa sequência de dígitos de 0 a 9 sem zeros à esquerda.

Exemplos

O exemplo seguinte apresenta um Int32 valor usando o método padrão ToString() . Apresenta também as representações das cadeias do Int32 valor resultantes da utilização de vários especificadores de formato padrão. Os exemplos são apresentados usando as convenções de formatação da cultura en-US.

int value = -16325;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325
Console.WriteLine(value.ToString("F"));         // Displays -16325.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325.00
Console.WriteLine(value.ToString("X"));         // Displays FFFFC03B

let value = -16325
// Display value using default ToString method.
printfn $"{value.ToString()}"                            // Displays -16325
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}"""         // Displays -16325
printfn $"""{value.ToString "C"}"""         // Displays ($16,325.00)
printfn $"""{value.ToString "D"}"""         // Displays -16325
printfn $"""{value.ToString "F"}"""         // Displays -16325.00
printfn $"""{value.ToString "N"}"""         // Displays -16,325.00
printfn $"""{value.ToString "X"}"""        // Displays FFFFC03B

Dim value As Integer = -16325
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.00)
Console.WriteLine(value.ToString("D"))         ' Displays -16325
Console.WriteLine(value.ToString("F"))         ' Displays -16325.00
Console.WriteLine(value.ToString("N"))         ' Displays -16,325.00
Console.WriteLine(value.ToString("X"))         ' Displays FFFFC03B

Observações

O ToString() método formata um Int32 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:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.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 padrão ou personalizada.

Devoluções

String

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

Exceções

FormatException

format é inválido ou não suportado.

Exemplos

O exemplo seguinte apresenta um Int32 valor usando cada um dos especificadores de formato numérico padrão suportados, juntamente com duas cadeias de formatos numéricos personalizadas. Ao converter os valores numéricos em cadeias, o exemplo utiliza as convenções de formatação da cultura en-US.

int value = -16325;
string specifier;

// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier));
// Displays:    P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    X: FFFFC03B

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): 16,325.00

let value = -16325

// Use standard numeric format specifier.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    G: -16325
let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    C: ($16,325.00)
let specifier = "D8"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    D8: -00016325
let specifier = "E4"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    E4: -1.6325E+004
let specifier = "e3"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    e3: -1.633e+004
let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    F: -16325.00
let specifier = "N"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    N: -16,325.00
let specifier = "P"
printfn $"{specifier}: {(value / 100000).ToString specifier}"
// Displays:    P: -16.33 %
let specifier = "X"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    X: FFFFC03B

// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    0,0.000: -16,325.000
let specifier = "#,#.00#;(#,#.00#)"
printfn $"{specifier}: {(value * -1).ToString specifier}"
// Displays:    #,#.00#;(#,#.00#): 16,325.00

Dim value As Integer = -16325
Dim specifier As String

' Use standard numeric format specifier.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: -16325
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: ($16,325.00)
specifier = "D8"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    D8: -00016325
specifier = "E4"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E4: -1.6325E+004
specifier = "e3"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    e3: -1.633e+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: -16325.00
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: -16,325.00
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier))
' Displays:    P: -16.33 %
specifier = "X"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    X: FFFFC03B 

' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays:    #,#.00#;(#,#.00#): 16,325.00

Observações

O ToString(String) método formata um Int32 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 qualquer especificador válido de formato numérico padrão, exceto "R", bem como qualquer combinação de especificadores de formato numérico personalizados. Se format for null ou uma cadeia vazia (""), o valor de retorno desta instância é formatado com o especificador geral de formato numérico ("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:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.cs

Origem:: Int32.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 específica de formato 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 padrão ou personalizada.

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)

Exceções

FormatException

format é inválido ou não suportado.

Exemplos

O exemplo seguinte apresenta um valor positivo e um negativo usando cada um dos especificadores de formato numérico padrão suportados para três culturas diferentes.

// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
                          CultureInfo.CreateSpecificCulture("fr-FR"),
                          CultureInfo.CreateSpecificCulture("es-ES") };
int positiveNumber = 1679;
int negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"};

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",
                        specifier, culture.Name,
                        positiveNumber.ToString(specifier, culture),
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//       G format using en-US culture:             1679            -3045
//       G format using fr-FR culture:             1679            -3045
//       G format using es-ES culture:             1679            -3045
//
//       C format using en-US culture:        $1,679.00      ($3,045.00)
//       C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//       C format using es-ES culture:       1.679,00 €      -3.045,00 €
//
//       D8 format using en-US culture:         00001679        -00003045
//       D8 format using fr-FR culture:         00001679        -00003045
//       D8 format using es-ES culture:         00001679        -00003045
//
//       E2 format using en-US culture:        1.68E+003       -3.05E+003
//       E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//       E2 format using es-ES culture:        1,68E+003       -3,05E+003
//
//       F format using en-US culture:          1679.00         -3045.00
//       F format using fr-FR culture:          1679,00         -3045,00
//       F format using es-ES culture:          1679,00         -3045,00
//
//       N format using en-US culture:         1,679.00        -3,045.00
//       N format using fr-FR culture:         1 679,00        -3 045,00
//       N format using es-ES culture:         1.679,00        -3.045,00
//
//       P format using en-US culture:     167,900.00 %    -304,500.00 %
//       P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//       P format using es-ES culture:     167.900,00 %    -304.500,00 %
//
//       X8 format using en-US culture:         0000068F         FFFFF41B
//       X8 format using fr-FR culture:         0000068F         FFFFF41B
//       X8 format using es-ES culture:         0000068F         FFFFF41B

// Define cultures whose formatting conventions are to be used.
let cultures = 
    [ CultureInfo.CreateSpecificCulture "en-US"
      CultureInfo.CreateSpecificCulture "fr-FR"
      CultureInfo.CreateSpecificCulture "es-ES" ]
let positiveNumber = 1679
let negativeNumber = -3045
let specifiers = [ "G"; "C"; "D8"; "E2"; "F"; "N"; "P"; "X8" ]

for specifier in specifiers do
    for culture in cultures do
        // Display values format specifiers.
        printfn $"{specifier} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"
    printfn ""

// The example displays the following output:
//       G format using en-US culture:             1679            -3045
//       G format using fr-FR culture:             1679            -3045
//       G format using es-ES culture:             1679            -3045
//
//       C format using en-US culture:        $1,679.00      ($3,045.00)
//       C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//       C format using es-ES culture:       1.679,00 €      -3.045,00 €
//
//       D8 format using en-US culture:         00001679        -00003045
//       D8 format using fr-FR culture:         00001679        -00003045
//       D8 format using es-ES culture:         00001679        -00003045
//
//       E2 format using en-US culture:        1.68E+003       -3.05E+003
//       E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//       E2 format using es-ES culture:        1,68E+003       -3,05E+003
//
//       F format using en-US culture:          1679.00         -3045.00
//       F format using fr-FR culture:          1679,00         -3045,00
//       F format using es-ES culture:          1679,00         -3045,00
//
//       N format using en-US culture:         1,679.00        -3,045.00
//       N format using fr-FR culture:         1 679,00        -3 045,00
//       N format using es-ES culture:         1.679,00        -3.045,00
//
//       P format using en-US culture:     167,900.00 %    -304,500.00 %
//       P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//       P format using es-ES culture:     167.900,00 %    -304.500,00 %
//
//       X8 format using en-US culture:         0000068F         FFFFF41B
//       X8 format using fr-FR culture:         0000068F         FFFFF41B
//       X8 format using es-ES culture:         0000068F         FFFFF41B

' 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 positiveNumber As Integer = 1679
Dim negativeNumber As Integer = -3045
Dim specifiers() As String = {"G", "C", "D8", "E2", "F", "N", "P", "X8"} 

For Each specifier As String In specifiers
   For Each culture As CultureInfo In Cultures
      ' Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}", _ 
                        specifier, culture.Name, _
                        positiveNumber.ToString(specifier, culture), _
                        negativeNumber.ToString(specifier, culture))

   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'       G format using en-US culture:             1679            -3045
'       G format using fr-FR culture:             1679            -3045
'       G format using es-ES culture:             1679            -3045
'       
'       C format using en-US culture:        $1,679.00      ($3,045.00)
'       C format using fr-FR culture:       1 679,00 €      -3 045,00 €
'       C format using es-ES culture:       1.679,00 €      -3.045,00 €
'       
'       D8 format using en-US culture:         00001679        -00003045
'       D8 format using fr-FR culture:         00001679        -00003045
'       D8 format using es-ES culture:         00001679        -00003045
'       
'       E2 format using en-US culture:        1.68E+003       -3.05E+003
'       E2 format using fr-FR culture:        1,68E+003       -3,05E+003
'       E2 format using es-ES culture:        1,68E+003       -3,05E+003
'       
'       F format using en-US culture:          1679.00         -3045.00
'       F format using fr-FR culture:          1679,00         -3045,00
'       F format using es-ES culture:          1679,00         -3045,00
'       
'       N format using en-US culture:         1,679.00        -3,045.00
'       N format using fr-FR culture:         1 679,00        -3 045,00
'       N format using es-ES culture:         1.679,00        -3.045,00
'       
'       P format using en-US culture:     167,900.00 %    -304,500.00 %
'       P format using fr-FR culture:     167 900,00 %    -304 500,00 %
'       P format using es-ES culture:     167.900,00 %    -304.500,00 %
'       
'       X8 format using en-US culture:         0000068F         FFFFF41B
'       X8 format using fr-FR culture:         0000068F         FFFFF41B
'       X8 format using es-ES culture:         0000068F         FFFFF41B

Observações

O ToString(String, IFormatProvider) método formata um Int32 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 (""), o valor de retorno para esta instância é formatado com o especificador geral de formato numérico ("G").

O provider parâmetro é um objeto que implementa a IFormatProvider interface. O seu GetFormat método devolve um NumberFormatInfo objeto que fornece informação de formato específica para 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 e cujo GetFormat método devolve um NumberFormatInfo objeto que fornece informação de formatação.

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

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

Comentários

Esta página foi útil?