SByte.ToString Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente.
Surcharges
| Nom | Description |
|---|---|
| ToString() |
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente. |
| ToString(IFormatProvider) |
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture spécifiées. |
| ToString(String) |
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente, à l’aide du format spécifié. |
| ToString(String, IFormatProvider) |
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture et au format spécifiés. |
ToString()
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente.
public:
override System::String ^ ToString();
public override string ToString();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Retours
Représentation sous forme de chaîne de la valeur de cette instance, constituée d’un signe négatif si la valeur est négative et d’une séquence de chiffres allant de 0 à 9 sans zéros non significatifs.
Exemples
L’exemple suivant affiche une SByte valeur à l’aide de la méthode par défaut ToString() . Il affiche également les représentations sous forme de chaîne de la valeur résultant de l’utilisation SByte d’un certain nombre de spécificateurs de format standard. Les exemples sont affichés à l’aide des conventions de mise en forme de la culture 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
Remarques
La ToString() méthode met en forme une SByte valeur au format par défaut (« G » ou général) de la culture actuelle. Si vous souhaitez spécifier un format ou une culture différent, utilisez les autres surcharges de la ToString méthode, comme suit :
| Pour utiliser le format | Pour la culture | Utiliser la surcharge |
|---|---|---|
| Format par défaut (« G ») | Une culture spécifique | ToString(IFormatProvider) |
| Un format spécifique | Culture par défaut (actuelle) | ToString(String) |
| Un format spécifique | Une culture spécifique | ToString(String, IFormatProvider) |
La valeur de retour est mise en forme à l’aide du spécificateur de format numérique général (« G ») La représentation sous forme de chaîne de la SByte valeur inclut un signe négatif si sa valeur est négative et une séquence de chiffres compris entre 0 et 9 sans zéros non significatifs. Le signe négatif est défini par l’objet NumberFormatInfo de la culture actuelle.
Pour définir la mise en forme de la représentation sous forme de chaîne de la valeur d’octet signée, appelez la ToString(String) méthode.
Voir aussi
- Types de mise en forme dans .NET
- Chaînes de format numériques standard
- Chaînes de format numérique personnalisées
S’applique à
ToString(IFormatProvider)
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture spécifiées.
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
Paramètres
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture.
Retours
Représentation sous forme de chaîne de la valeur de cette instance, comme spécifié par provider.
Implémente
Exemples
L’exemple suivant définit un objet personnalisé NumberFormatInfo et affecte le caractère « ~ » à sa NegativeSign propriété. L’exemple utilise ensuite cet objet personnalisé ainsi que l’objet NumberFormatInfo de la culture invariante pour mettre en forme une série de SByte valeurs.
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
Remarques
La ToString(IFormatProvider) méthode met en forme une SByte valeur au format par défaut (« G » ou général) d’une culture spécifiée. Si vous souhaitez spécifier un format différent ou la culture actuelle, utilisez les autres surcharges de la ToString méthode, comme suit :
| Pour utiliser le format | Pour la culture | Utiliser la surcharge |
|---|---|---|
| Format par défaut (« G ») | Culture par défaut (actuelle) | ToString() |
| Un format spécifique | Culture par défaut (actuelle) | ToString(String) |
| Un format spécifique | Une culture spécifique | ToString(String, IFormatProvider) |
Le provider paramètre est une IFormatProvider implémentation. Sa GetFormat méthode retourne un NumberFormatInfo objet qui fournit des informations spécifiques à la culture sur le format de la chaîne retournée par cette méthode. Si provider c’est nullle cas, la SByte valeur est mise en forme à l’aide de l’objet NumberFormatInfo de la culture actuelle. La seule propriété de l’objet NumberFormatInfo qui contrôle la représentation sous forme de chaîne de la SByte valeur à l’aide du spécificateur de format général est NumberFormatInfo.NegativeSign, qui définit le caractère qui représente le signe négatif.
Le provider paramètre peut être l’un des éléments suivants :
Objet CultureInfo qui représente la culture qui fournit des informations de mise en forme.
Objet NumberFormatInfo qui fournit des informations de mise en forme.
Objet personnalisé qui implémente IFormatProvider. Sa GetFormat méthode retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme.
Voir aussi
- Types de mise en forme dans .NET
- Chaînes de format numériques standard
- Chaînes de format numérique personnalisées
S’applique à
ToString(String)
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente, à l’aide du format spécifié.
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
Paramètres
- format
- String
Chaîne de format numérique standard ou personnalisée.
Retours
Représentation sous forme de chaîne de la valeur de cette instance spécifiée par format.
Exceptions
format n’est pas valide.
Exemples
L’exemple suivant initialise un tableau de valeurs et les affiche à l’aide de SByte chaque chaîne de format standard et de certaines chaînes de format personnalisées.
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
Remarques
La ToString(String) méthode met en forme une SByte valeur dans un format spécifié à l’aide des conventions de la culture actuelle. Si vous souhaitez utiliser le format par défaut (« G » ou général) ou spécifier une culture différente, utilisez les autres surcharges de la ToString méthode, comme suit :
| Pour utiliser le format | Pour la culture | Utiliser la surcharge |
|---|---|---|
| Format par défaut (« G ») | Culture par défaut (actuelle) | ToString() |
| Format par défaut (« G ») | Une culture spécifique | ToString(IFormatProvider) |
| Un format spécifique | Une culture spécifique | ToString(String, IFormatProvider) |
Le format paramètre peut être n’importe quel spécificateur de format numérique standard valide ou toute combinaison de spécificateurs de format numérique personnalisés. Si format elle est égale ou égale nullà String.Empty , la valeur de retour de l’objet actuel SByte est mise en forme avec le spécificateur de format général (« G »). S’il format s’agit d’une autre valeur, la méthode lève un FormatException.
.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :
Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et chaînes de format numérique personnalisées.
Pour plus d’informations sur la prise en charge de la mise en forme dans .NET, consultez Types de mise en forme.
Le format de la chaîne retournée est déterminé par l’objet NumberFormatInfo de la culture actuelle. Selon le format paramètre, cet objet contrôle les symboles tels que le signe négatif, le séparateur de groupe et le symbole décimal dans la chaîne de sortie. Pour fournir des informations de mise en forme pour les cultures autres que la culture actuelle, appelez la ToString(String, IFormatProvider) surcharge.
Voir aussi
- Types de mise en forme dans .NET
- How to : Pad a Number with Leading Zeros
- Chaînes de format numériques standard
- Chaînes de format numérique personnalisées
S’applique à
ToString(String, IFormatProvider)
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture et au format spécifiés.
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
Paramètres
- format
- String
Chaîne de format numérique standard ou personnalisée.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture.
Retours
Représentation sous forme de chaîne de la valeur de cette instance spécifiée par format et provider.
Implémente
Exceptions
format n’est pas valide.
Exemples
L’exemple suivant affiche à la fois une valeur positive et négative SByte à l’aide des spécificateurs de format numérique standard et un certain nombre d’objets spécifiques 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
Remarques
La ToString(String, IFormatProvider) méthode met en forme une SByte valeur dans un format spécifié d’une culture spécifiée. Si vous souhaitez utiliser des paramètres de mise en forme ou de culture par défaut, utilisez les autres surcharges de la ToString méthode, comme suit :
| Pour utiliser le format | Pour la culture | Utiliser la surcharge |
|---|---|---|
| Format par défaut (« G ») | Culture par défaut (actuelle) | ToString() |
| Format par défaut (« G ») | Une culture spécifique | ToString(IFormatProvider) |
| Un format spécifique | Culture par défaut (actuelle) | ToString(String) |
Le format paramètre peut être n’importe quel spécificateur de format numérique standard valide ou toute combinaison de spécificateurs de format numérique personnalisés. Si format elle est égale ou égale nullà String.Empty , la valeur de retour de l’objet actuel SByte est mise en forme avec le spécificateur de format général (« G »). S’il format s’agit d’une autre valeur, la méthode lève un FormatException.
.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :
Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et chaînes de format numérique personnalisées.
Pour plus d’informations sur la prise en charge de la mise en forme dans .NET, consultez Types de mise en forme.
Le provider paramètre est une IFormatProvider implémentation. Sa GetFormat méthode retourne un NumberFormatInfo objet qui fournit des informations spécifiques à la culture sur le format de la chaîne retournée par cette méthode. Lorsque la ToString(String, IFormatProvider) méthode est appelée, elle appelle la provider méthode du IFormatProvider.GetFormat paramètre et la transmet à un Type objet qui représente le NumberFormatInfo type. La GetFormat méthode retourne ensuite l’objet qui fournit des informations pour mettre NumberFormatInfo en forme le value paramètre, comme le symbole de signe négatif, le symbole de séparateur de groupe ou le symbole de virgule décimale. Il existe trois façons d’utiliser le provider paramètre pour fournir des informations de mise en forme à la ToString(String, IFormatProvider) méthode :
Vous pouvez transmettre un CultureInfo objet qui représente la culture qui fournit des informations de mise en forme. Sa GetFormat méthode retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme numériques pour cette culture.
Vous pouvez transmettre l’objet réel NumberFormatInfo qui fournit des informations de mise en forme numérique. (Son implémentation de GetFormat just returns lui-même.)
Vous pouvez passer un objet personnalisé qui implémente IFormatProvider. Sa GetFormat méthode instancie et retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme.
Si provider c’est nullle cas, la mise en forme de la chaîne retournée est basée sur l’objet NumberFormatInfo de la culture actuelle.
Voir aussi
- Types de mise en forme dans .NET
- How to : Pad a Number with Leading Zeros
- Chaînes de format numériques standard
- Chaînes de format numérique personnalisées
- exemple : Utilitaire de mise en forme WinForms .NET Core (C#)
- exemple : Utilitaire de mise en forme WinForms .NET Core (Visual Basic)