SByte.ToString Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente.
Sobrecargas
| Nome | Description |
|---|---|
| ToString() |
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente. |
| ToString(IFormatProvider) |
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificadas. |
| ToString(String) |
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando o formato especificado. |
| ToString(String, IFormatProvider) |
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura. |
ToString()
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente.
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 um sinal negativo se o valor for negativo, e uma sequência de dígitos variando de 0 a 9 sem zeros à esquerda.
Exemplos
O exemplo a seguir exibe um SByte valor usando o método padrão ToString() . Ele também exibe as representações de cadeia de caracteres do SByte valor resultante do uso de vários especificadores de formato padrão. Os exemplos são exibidos usando as convenções de formatação da cultura en-US.
using System;
public class Example
{
public static void Main()
{
sbyte value = -123;
// Display value using default ToString method.
Console.WriteLine(value.ToString()); // Displays -123
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")); // Displays -123
Console.WriteLine(value.ToString("C")); // Displays ($-123.00)
Console.WriteLine(value.ToString("D")); // Displays -123
Console.WriteLine(value.ToString("F")); // Displays -123.00
Console.WriteLine(value.ToString("N")); // Displays -123.00
Console.WriteLine(value.ToString("X")); // Displays 85
}
}
let value = -123y
// Display value using default ToString method.
printfn $"{value.ToString()}" // Displays -123
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}""" // Displays -123
printfn $"""{value.ToString "C"}""" // Displays ($-123.00)
printfn $"""{value.ToString "D"}""" // Displays -123
printfn $"""{value.ToString "F"}""" // Displays -123.00
printfn $"""{value.ToString "N"}""" // Displays -123.00
printfn $"""{value.ToString "X"}""" // Displays 85
Module Example
Public Sub Main()
Dim value As SByte = -123
' Display value using default ToString method.
Console.WriteLine(value.ToString()) ' Displays -123
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")) ' Displays -123
Console.WriteLine(value.ToString("C")) ' Displays ($-123.00)
Console.WriteLine(value.ToString("D")) ' Displays -123
Console.WriteLine(value.ToString("F")) ' Displays -123.00
Console.WriteLine(value.ToString("N")) ' Displays -123.00
Console.WriteLine(value.ToString("X")) ' Displays 85
End Sub
End Module
Comentários
O ToString() método formata um SByte valor no formato padrão ("G" ou geral) da cultura atual. Se você quiser especificar um formato ou cultura diferente, use as outras sobrecargas do método ToString da seguinte maneira:
| Para usar o formato | Para cultura | Usar a sobrecarga |
|---|---|---|
| Formato padrão ("G") | Uma cultura específica | ToString(IFormatProvider) |
| Um formato específico | Cultura padrão (atual) | ToString(String) |
| Um formato específico | Uma cultura específica | ToString(String, IFormatProvider) |
O valor retornado é formatado usando o especificador de formato numérico geral ("G") A representação de cadeia de caracteres do SByte valor inclui um sinal negativo se seu valor for negativo e uma sequência de dígitos variando de 0 a 9 sem zeros à esquerda. O sinal negativo é definido pelo objeto NumberFormatInfo para a cultura atual.
Para definir a formatação da representação de cadeia de caracteres do valor de byte assinado, chame o ToString(String) método.
Confira também
- Tipos de formatação no .NET
- Cadeias de Caracteres de Formato Numérico Padrão
- Cadeias de Formato Numérico Personalizado
Aplica-se a
ToString(IFormatProvider)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificadas.
public:
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ções de formatação específicas da cultura.
Retornos
A representação de cadeia de caracteres do valor dessa instância, conforme especificado por provider.
Implementações
Exemplos
O exemplo a seguir define um objeto personalizado NumberFormatInfo e atribui o caractere "~" à sua NegativeSign propriedade. Em seguida, o exemplo usa esse objeto personalizado, bem como o NumberFormatInfo objeto da cultura invariável para formatar uma série de SByte valores.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define a custom NumberFormatInfo object with "~" as its negative sign.
NumberFormatInfo nfi = new NumberFormatInfo();
nfi.NegativeSign = "~";
// Initialize an array of SByte values.
sbyte[] bytes = { -122, 17, 124 };
// Display the formatted result using the custom provider.
Console.WriteLine("Using the custom NumberFormatInfo object:");
foreach (sbyte value in bytes)
Console.WriteLine(value.ToString(nfi));
Console.WriteLine();
// Display the formatted result using the invariant culture.
Console.WriteLine("Using the invariant culture:");
foreach (sbyte value in bytes)
Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo));
}
}
// The example displays the following output:
// Using the custom NumberFormatInfo object:
// ~122
// 17
// 124
//
// Using the invariant culture:
// -122
// 17
// 124
open System.Globalization
// Define a custom NumberFormatInfo object with "~" as its negative sign.
let nfi = NumberFormatInfo(NegativeSign = "~")
// Initialize an array of SByte values.
let bytes = [| -122y; 17y; 124y |]
// Display the formatted result using the custom provider.
printfn "Using the custom NumberFormatInfo object:"
for value in bytes do
printfn $"{value.ToString nfi}"
printfn ""
// Display the formatted result using the invariant culture.
printfn "Using the invariant culture:"
for value in bytes do
printfn $"{value.ToString NumberFormatInfo.InvariantInfo}"
// The example displays the following output:
// Using the custom NumberFormatInfo object:
// ~122
// 17
// 124
//
// Using the invariant culture:
// -122
// 17
// 124
Imports System.Globalization
Module Example
Public Sub Main()
' Define a custom NumberFormatInfo object with "~" as its negative sign.
Dim nfi As New NumberFormatInfo()
nfi.NegativeSign = "~"
' Initialize an array of SByte values.
Dim bytes() As SByte = { -122, 17, 124 }
' Display the formatted result using the custom provider.
Console.WriteLine("Using the custom NumberFormatInfo object:")
For Each value As SByte In bytes
Console.WriteLine(value.ToString(nfi))
Next
Console.WriteLine()
' Display the formatted result using the invariant culture.
Console.WriteLine("Using the invariant culture:")
For Each value As SByte In bytes
Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo))
Next
End Sub
End Module
' The example displays the following output:
' Using the custom NumberFormatInfo object:
' ~122
' 17
' 124
'
' Using the invariant culture:
' -122
' 17
' 124
Comentários
O ToString(IFormatProvider) método formata um SByte valor no formato padrão ("G" ou geral) de uma cultura especificada. Se você quiser especificar um formato diferente ou a cultura atual, use as outras sobrecargas do método ToString, da seguinte maneira:
| Para usar o formato | Para cultura | Usar a sobrecarga |
|---|---|---|
| Formato padrão ("G") | Cultura padrão (atual) | ToString() |
| Um formato específico | Cultura padrão (atual) | ToString(String) |
| Um formato específico | Uma cultura específica | ToString(String, IFormatProvider) |
O provider parâmetro é uma implementação IFormatProvider . Seu método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas da cultura sobre o formato da cadeia de caracteres retornada por esse método. Se provider for null, o valor SByte será formatado usando o objeto NumberFormatInfo da cultura atual. A única propriedade do objeto NumberFormatInfo que controla a representação de cadeia de caracteres do valor SByte usando o especificador de formato geral é NumberFormatInfo.NegativeSign, que define o caractere que representa o sinal negativo.
O parâmetro provider pode ser um dos seguintes:
Um CultureInfo objeto que representa a cultura que fornece informações de formatação.
O objeto NumberFormatInfo que fornece informações de formatação.
Um objeto personalizado que implementa IFormatProvider. Seu método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação.
Confira também
- Tipos de formatação no .NET
- Cadeias de Caracteres de Formato Numérico Padrão
- Cadeias de Formato Numérico Personalizado
Aplica-se a
ToString(String)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente 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 caracteres de formato numérico padrão ou personalizado.
Retornos
A representação da cadeia de caracteres do valor dessa instância conforme especificado por format.
Exceções
format é inválido.
Exemplos
O exemplo a seguir inicializa uma matriz de SByte valores e os exibe usando cada cadeia de caracteres de formato padrão e algumas cadeias de caracteres de formato personalizado.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
sbyte[] values = { -124, 0, 118 };
string[] specifiers = { "G", "C", "D3", "E2", "e3", "F",
"N", "P", "X", "00.0", "#.0",
"000;(0);**Zero**" };
foreach (sbyte value in values)
{
foreach (string specifier in specifiers)
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
Console.WriteLine();
}
}
}
// The example displays the following output:
// G: -124
// C: ($124.00)
// D3: -124
// E2: -1.24E+002
// e3: -1.240e+002
// F: -124.00
// N: -124.00
// P: -12,400.00 %
// X: 84
// 00.0: -124.0
// #.0: -124.0
// 000;(0);**Zero**: (124)
//
// G: 0
// C: $0.00
// D3: 000
// E2: 0.00E+000
// e3: 0.000e+000
// F: 0.00
// N: 0.00
// P: 0.00 %
// X: 0
// 00.0: 00.0
// #.0: .0
// 000;(0);**Zero**: **Zero**
//
// G: 118
// C: $118.00
// D3: 118
// E2: 1.18E+002
// e3: 1.180e+002
// F: 118.00
// N: 118.00
// P: 11,800.00 %
// X: 76
// 00.0: 118.0
// #.0: 118.0
// 000;(0);**Zero**: 118
let values = [| -124y; 0y; 118y |]
let specifiers =
[| "G"; "C"; "D3"; "E2"; "e3"; "F"
"N"; "P"; "X"; "00.0"; "#.0"
"000(0)**Zero**" |]
for value in values do
for specifier in specifiers do
printfn $"{specifier}: {value.ToString specifier}"
printfn ""
// The example displays the following output:
// G: -124
// C: ($124.00)
// D3: -124
// E2: -1.24E+002
// e3: -1.240e+002
// F: -124.00
// N: -124.00
// P: -12,400.00 %
// X: 84
// 00.0: -124.0
// #.0: -124.0
// 000(0)**Zero**: (124)
//
// G: 0
// C: $0.00
// D3: 000
// E2: 0.00E+000
// e3: 0.000e+000
// F: 0.00
// N: 0.00
// P: 0.00 %
// X: 0
// 00.0: 00.0
// #.0: .0
// 000(0)**Zero**: **Zero**
//
// G: 118
// C: $118.00
// D3: 118
// E2: 1.18E+002
// e3: 1.180e+002
// F: 118.00
// N: 118.00
// P: 11,800.00 %
// X: 76
// 00.0: 118.0
// #.0: 118.0
// 000(0)**Zero**: 118
Imports System.Globalization
Module Example
Public Sub Main()
Dim values() As SByte = { -124, 0, 118 }
Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
"N", "P", "X", "00.0", "#.0", _
"000;(0);**Zero**" }
For Each value As SByte In values
For Each specifier As String In specifiers
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' G: -124
' C: ($124.00)
' D3: -124
' E2: -1.24E+002
' e3: -1.240e+002
' F: -124.00
' N: -124.00
' P: -12,400.00 %
' X: 84
' 00.0: -124.0
' #.0: -124.0
' 000;(0);**Zero**: (124)
'
' G: 0
' C: $0.00
' D3: 000
' E2: 0.00E+000
' e3: 0.000e+000
' F: 0.00
' N: 0.00
' P: 0.00 %
' X: 0
' 00.0: 00.0
' #.0: .0
' 000;(0);**Zero**: **Zero**
'
' G: 118
' C: $118.00
' D3: 118
' E2: 1.18E+002
' e3: 1.180e+002
' F: 118.00
' N: 118.00
' P: 11,800.00 %
' X: 76
' 00.0: 118.0
' #.0: 118.0
' 000;(0);**Zero**: 118
Comentários
O ToString(String) método formata um SByte valor em um formato especificado usando as convenções da cultura atual. Se você quiser usar o formato padrão ("G" ou geral) ou especificar uma cultura diferente, use as outras sobrecargas do ToString método, da seguinte maneira:
| Para usar o formato | Para cultura | Usar a sobrecarga |
|---|---|---|
| Formato padrão ("G") | Cultura padrão (atual) | ToString() |
| Formato padrão ("G") | Uma cultura específica | ToString(IFormatProvider) |
| Um formato específico | Uma cultura específica | ToString(String, IFormatProvider) |
O format parâmetro pode ser qualquer especificador de formato numérico padrão válido ou qualquer combinação de especificadores de formato numérico personalizado. Se format for igual ou String.Empty for null, o valor retornado do objeto atual SByte será formatado com o especificador de formato geral ("G"). Se format for qualquer outro valor, o método gerará um FormatException.
O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:
Para obter mais informações sobre especificadores de formato numérico, consulte Cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre o suporte à formatação no .NET, consulte Tipos de Formatação.
O formato da cadeia de caracteres retornada é determinado pelo objeto NumberFormatInfo para a cultura atual. Dependendo do parâmetro format, esse objeto controla símbolos como o sinal negativo, o separador de grupo e o símbolo de ponto decimal na cadeia de caracteres de saída. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame a sobrecarga de ToString(String, IFormatProvider).
Confira também
- Tipos de formatação no .NET
- Como adicionar um número com zeros à esquerda
- Cadeias de Caracteres de Formato Numérico Padrão
- Cadeias de Formato Numérico Personalizado
Aplica-se a
ToString(String, IFormatProvider)
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
- Origem:
- SByte.cs
Converte o valor numérico dessa instância em sua representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.
public:
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 caracteres de formato numérico padrão ou personalizado.
- provider
- IFormatProvider
Um objeto que fornece informações de formatação específicas da cultura.
Retornos
A representação de cadeia de caracteres do valor dessa instância, conforme especificado por format e provider.
Implementações
Exceções
format é inválido.
Exemplos
O exemplo a seguir exibe um valor positivo e negativo SByte usando os especificadores de formato numérico padrão e vários objetos específicos CultureInfo .
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") };
sbyte positiveNumber = 119;
sbyte negativeNumber = -45;
string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"};
foreach (string specifier in specifiers)
{
foreach (CultureInfo culture in cultures)
Console.WriteLine("{0,2} 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: 119 -45
// G format using fr-FR culture: 119 -45
// G format using es-ES culture: 119 -45
//
// C format using en-US culture: $119.00 ($45.00)
// C format using fr-FR culture: 119,00 € -45,00 €
// C format using es-ES culture: 119,00 € -45,00 €
//
// D4 format using en-US culture: 0119 -0045
// D4 format using fr-FR culture: 0119 -0045
// D4 format using es-ES culture: 0119 -0045
//
// E2 format using en-US culture: 1.19E+002 -4.50E+001
// E2 format using fr-FR culture: 1,19E+002 -4,50E+001
// E2 format using es-ES culture: 1,19E+002 -4,50E+001
//
// F format using en-US culture: 119.00 -45.00
// F format using fr-FR culture: 119,00 -45,00
// F format using es-ES culture: 119,00 -45,00
//
// N format using en-US culture: 119.00 -45.00
// N format using fr-FR culture: 119,00 -45,00
// N format using es-ES culture: 119,00 -45,00
//
// P format using en-US culture: 11,900.00 % -4,500.00 %
// P format using fr-FR culture: 11 900,00 % -4 500,00 %
// P format using es-ES culture: 11.900,00 % -4.500,00 %
//
// X2 format using en-US culture: 77 D3
// X2 format using fr-FR culture: 77 D3
// X2 format using es-ES culture: 77 D3
open System.Globalization
// 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 = 119y
let negativeNumber = -45y
let specifiers = [| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |]
for specifier in specifiers do
for culture in cultures do
printfn $"{specifier,2} 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: 119 -45
// G format using fr-FR culture: 119 -45
// G format using es-ES culture: 119 -45
//
// C format using en-US culture: $119.00 ($45.00)
// C format using fr-FR culture: 119,00 € -45,00 €
// C format using es-ES culture: 119,00 € -45,00 €
//
// D4 format using en-US culture: 0119 -0045
// D4 format using fr-FR culture: 0119 -0045
// D4 format using es-ES culture: 0119 -0045
//
// E2 format using en-US culture: 1.19E+002 -4.50E+001
// E2 format using fr-FR culture: 1,19E+002 -4,50E+001
// E2 format using es-ES culture: 1,19E+002 -4,50E+001
//
// F format using en-US culture: 119.00 -45.00
// F format using fr-FR culture: 119,00 -45,00
// F format using es-ES culture: 119,00 -45,00
//
// N format using en-US culture: 119.00 -45.00
// N format using fr-FR culture: 119,00 -45,00
// N format using es-ES culture: 119,00 -45,00
//
// P format using en-US culture: 11,900.00 % -4,500.00 %
// P format using fr-FR culture: 11 900,00 % -4 500,00 %
// P format using es-ES culture: 11.900,00 % -4.500,00 %
//
// X2 format using en-US culture: 77 D3
// X2 format using fr-FR culture: 77 D3
// X2 format using es-ES culture: 77 D3
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 positiveNumber As SByte = 119
Dim negativeNumber As SByte = -45
Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}
For Each specifier As String In specifiers
For Each culture As CultureInfo In Cultures
Console.WriteLine("{0,2} format using {1} culture: {2, 16} {3, 16}", _
specifier, culture.Name, _
positiveNumber.ToString(specifier, culture), _
negativeNumber.ToString(specifier, culture))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' G format using en-US culture: 119 -45
' G format using fr-FR culture: 119 -45
' G format using es-ES culture: 119 -45
'
' C format using en-US culture: $119.00 ($45.00)
' C format using fr-FR culture: 119,00 € -45,00 €
' C format using es-ES culture: 119,00 € -45,00 €
'
' D4 format using en-US culture: 0119 -0045
' D4 format using fr-FR culture: 0119 -0045
' D4 format using es-ES culture: 0119 -0045
'
' E2 format using en-US culture: 1.19E+002 -4.50E+001
' E2 format using fr-FR culture: 1,19E+002 -4,50E+001
' E2 format using es-ES culture: 1,19E+002 -4,50E+001
'
' F format using en-US culture: 119.00 -45.00
' F format using fr-FR culture: 119,00 -45,00
' F format using es-ES culture: 119,00 -45,00
'
' N format using en-US culture: 119.00 -45.00
' N format using fr-FR culture: 119,00 -45,00
' N format using es-ES culture: 119,00 -45,00
'
' P format using en-US culture: 11,900.00 % -4,500.00 %
' P format using fr-FR culture: 11 900,00 % -4 500,00 %
' P format using es-ES culture: 11.900,00 % -4.500,00 %
'
' X2 format using en-US culture: 77 D3
' X2 format using fr-FR culture: 77 D3
' X2 format using es-ES culture: 77 D3
Comentários
O ToString(String, IFormatProvider) método formata um SByte valor em um formato especificado de uma cultura especificada. Se você quiser usar as configurações de formato ou cultura padrão, use as outras sobrecargas do ToString método, da seguinte maneira:
| Para usar o formato | Para cultura | Usar a sobrecarga |
|---|---|---|
| Formato padrão ("G") | Cultura padrão (atual) | ToString() |
| Formato padrão ("G") | Uma cultura específica | ToString(IFormatProvider) |
| Um formato específico | Cultura padrão (atual) | ToString(String) |
O format parâmetro pode ser qualquer especificador de formato numérico padrão válido ou qualquer combinação de especificadores de formato numérico personalizado. Se format for igual ou String.Empty for null, o valor retornado do objeto atual SByte será formatado com o especificador de formato geral ("G"). Se format for qualquer outro valor, o método gerará um FormatException.
O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:
Para obter mais informações sobre especificadores de formato numérico, consulte Cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre o suporte à formatação no .NET, consulte Tipos de Formatação.
O provider parâmetro é uma implementação IFormatProvider . Seu método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas da cultura sobre o formato da cadeia de caracteres retornada por esse método. Quando o ToString(String, IFormatProvider) método é invocado, ele chama o provider método do IFormatProvider.GetFormat parâmetro e passa um Type objeto que representa o NumberFormatInfo tipo. O método GetFormat retorna o objeto NumberFormatInfo que fornece informações para formatar o parâmetro value, como o símbolo de sinal negativo, o símbolo separador de grupo ou o símbolo de ponto decimal. Há três maneiras de usar o parâmetro provider para fornecer informações de formatação ao método ToString(String, IFormatProvider):
Você pode passar um CultureInfo objeto que representa a cultura que fornece informações de formatação. Seu GetFormat método retorna o NumberFormatInfo objeto que fornece informações de formatação numérica para essa cultura.
Você pode passar o objeto real NumberFormatInfo que fornece informações de formatação numérica. (Sua implementação de GetFormat apenas retorna a si mesma.)
Você pode passar um objeto personalizado que implementa IFormatProvider. Seu GetFormat método cria uma instância e retorna o NumberFormatInfo objeto que fornece informações de formatação.
Se provider for null, a formatação da cadeia de caracteres retornada será baseada no objeto NumberFormatInfo da cultura atual.
Confira também
- Tipos de formatação no .NET
- Como adicionar um número com zeros à esquerda
- Cadeias de Caracteres de Formato Numérico Padrão
- Cadeias de Formato Numérico Personalizado
- Exemplo de : Utilitário de Formatação do WinForms do .NET Core (C#)
- Exemplo de : Utilitário de Formatação winforms do .NET Core (Visual Basic)