SByte.ToString Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.
Přetížení
ToString() |
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření. |
ToString(IFormatProvider) |
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určených informací o formátování specifických pro jazykovou verzi. |
ToString(String) |
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu. |
ToString(String, IFormatProvider) |
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu a informací o formátování specifických pro jazykovou verzi. |
ToString()
- Zdroj:
- SByte.cs
- Zdroj:
- SByte.cs
- Zdroj:
- SByte.cs
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Návraty
Řetězcová reprezentace hodnoty této instance, která se skládá ze záporného znaménka, pokud je hodnota záporná, a posloupnosti číslic v rozsahu od 0 do 9 bez počátečních nul.
Příklady
Následující příklad zobrazí SByte hodnotu pomocí výchozí ToString() metody. Zobrazí také řetězcové reprezentace SByte hodnoty, která je výsledkem použití řady specifikátorů standardního formátu. Příklady jsou zobrazeny pomocí konvencí formátování jazykové verze 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
Poznámky
Metoda ToString() formátuje SByte hodnotu ve výchozím ("G" nebo obecném) formátu aktuální jazykové verze. Pokud chcete zadat jiný formát nebo jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:
Použití formátu | Pro jazykovou verzi | Použití přetížení |
---|---|---|
Výchozí formát ("G") | Konkrétní jazyková verze | ToString(IFormatProvider) |
Konkrétní formát | Výchozí (aktuální) jazyková verze | ToString(String) |
Konkrétní formát | Konkrétní jazyková verze | ToString(String, IFormatProvider) |
Návratová hodnota je formátována pomocí obecného specifikátoru číselného SByte formátu ("G") Řetězcová reprezentace hodnoty obsahuje záporné znaménko, pokud je její hodnota záporná, a posloupnost číslic v rozsahu od 0 do 9 bez počátečních nul. Záporné znaménko je definováno objektem NumberFormatInfo pro aktuální jazykovou verzi.
Chcete-li definovat formátování řetězcové reprezentace hodnoty podepsaného bajtu, zavolejte metodu ToString(String) .
Viz také
Platí pro
ToString(IFormatProvider)
- Zdroj:
- SByte.cs
- Zdroj:
- SByte.cs
- Zdroj:
- SByte.cs
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určených informací o formátování specifických pro jazykovou verzi.
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
Parametry
- provider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.
Návraty
Řetězcová reprezentace hodnoty této instance, jak je určena parametrem provider
.
Implementuje
Příklady
Následující příklad definuje vlastní NumberFormatInfo objekt a přiřadí znak "~" jeho NegativeSign vlastnosti. Příklad pak použije tento vlastní objekt i NumberFormatInfo objekt invariantní jazykové verze k formátování řady SByte hodnot.
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
Poznámky
Metoda ToString(IFormatProvider) naformátuje SByte hodnotu ve výchozím ("G" nebo obecném) formátu zadané jazykové verze. Pokud chcete zadat jiný formát nebo aktuální jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:
Použití formátu | Pro jazykovou verzi | Použití přetížení |
---|---|---|
Výchozí formát ("G") | Výchozí (aktuální) jazyková verze | ToString() |
Konkrétní formát | Výchozí (aktuální) jazyková verze | ToString(String) |
Konkrétní formát | Konkrétní jazyková verze | ToString(String, IFormatProvider) |
Parametr provider
je IFormatProvider implementace. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické pro jazykovou verzi o formátu řetězce vráceného touto metodou. Pokud provider
je null
, SByte hodnota se naformátuje pomocí objektu NumberFormatInfo aktuální jazykové verze. Jediná vlastnost objektu NumberFormatInfo , která řídí řetězcovou reprezentaci SByte hodnoty pomocí obecného specifikátoru formátu, je NumberFormatInfo.NegativeSign, která definuje znak, který představuje záporné znaménko.
Parametr provider
může být jeden z následujících parametrů:
Objekt CultureInfo , který představuje jazykovou verzi, která poskytuje informace o formátování.
Objekt NumberFormatInfo , který poskytuje informace o formátování.
Vlastní objekt, který implementuje IFormatProvider. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace o formátování.
Viz také
Platí pro
ToString(String)
- Zdroj:
- SByte.cs
- Zdroj:
- SByte.cs
- Zdroj:
- SByte.cs
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu.
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
Parametry
- format
- String
Standardní nebo vlastní řetězec číselného formátu.
Návraty
Řetězcová reprezentace hodnoty této instance, jak je určena nástrojem format
.
Výjimky
Formát format
je neplatný.
Příklady
Následující příklad inicializuje pole hodnot a zobrazí je pomocí jednotlivých řetězců standardního formátu a některých řetězců vlastního SByte formátu.
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
Poznámky
Metoda ToString(String) formátuje SByte hodnotu v zadaném formátu pomocí konvencí aktuální jazykové verze. Pokud chcete použít výchozí formát ("G" nebo obecný) nebo zadat jinou jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:
Použití formátu | Pro jazykovou verzi | Použití přetížení |
---|---|---|
Výchozí formát ("G") | Výchozí (aktuální) jazyková verze | ToString() |
Výchozí formát ("G") | Konkrétní jazyková verze | ToString(IFormatProvider) |
Konkrétní formát | Konkrétní jazyková verze | ToString(String, IFormatProvider) |
Parametrem format
může být libovolný platný specifikátor číselného formátu nebo libovolná kombinace specifikátorů vlastního číselného formátu. Pokud format
je hodnota String.Empty rovna nebo je null
, je vrácená hodnota aktuálního SByte objektu naformátovaná pomocí obecného specifikátoru formátu ("G"). Pokud format
je jakákoli jiná hodnota, metoda vyvolá FormatException.
.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:
Další informace o specifikátorech číselného formátu najdete v tématech Řetězce standardního číselného formátu a Vlastní řetězce číselného formátu.
Další informace o podpoře formátování v .NET najdete v tématu Typy formátování.
Formát vráceného řetězce je určen objektem NumberFormatInfo pro aktuální jazykovou verzi. V závislosti na parametru format
tento objekt řídí symboly, jako je například záporné znaménko, oddělovač skupin a symbol desetinné čárky ve výstupním řetězci. Pokud chcete poskytnout informace o formátování pro jiné jazykové verze, než je aktuální jazyková verze, zavolejte ToString(String, IFormatProvider) přetížení.
Viz také
- Typy formátování v .NET
- Postupy: Vyplnění čísla úvodními nulami
- Standardní řetězce pro formátování čísel
- Vlastní řetězce číselného formátu
Platí pro
ToString(String, IFormatProvider)
- Zdroj:
- SByte.cs
- Zdroj:
- SByte.cs
- Zdroj:
- SByte.cs
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu a informací o formátování specifických pro jazykovou verzi.
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
Parametry
- format
- String
Standardní nebo vlastní řetězec číselného formátu.
- provider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.
Návraty
Řetězcové vyjádření hodnoty této instance podle a format
provider
.
Implementuje
Výjimky
Formát format
je neplatný.
Příklady
Následující příklad zobrazuje kladnou i zápornou SByte hodnotu pomocí standardních specifikátorů číselného formátu a počtu konkrétních CultureInfo objektů.
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
Poznámky
Metoda ToString(String, IFormatProvider) formátuje SByte hodnotu v zadaném formátu zadané jazykové verze. Pokud chcete použít výchozí nastavení formátu nebo jazykové verze, použijte další přetížení ToString metody následujícím způsobem:
Použití formátu | Pro jazykovou verzi | Použití přetížení |
---|---|---|
Výchozí formát ("G") | Výchozí (aktuální) jazyková verze | ToString() |
Výchozí formát ("G") | Konkrétní jazyková verze | ToString(IFormatProvider) |
Konkrétní formát | Výchozí (aktuální) jazyková verze | ToString(String) |
Parametrem format
může být libovolný platný specifikátor číselného formátu nebo libovolná kombinace specifikátorů vlastního číselného formátu. Pokud format
je hodnota String.Empty rovna nebo je null
, návratová hodnota aktuálního SByte objektu se naformátuje pomocí obecného specifikátoru formátu ("G"). Pokud format
je jakákoli jiná hodnota, metoda vyvolá FormatException.
.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:
Další informace o specifikátorech číselného formátu najdete v tématech Řetězce standardního číselného formátu a Vlastní řetězce číselného formátu.
Další informace o podpoře formátování v .NET najdete v tématu Typy formátování.
Parametr provider
je IFormatProvider implementace. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické pro jazykovou verzi o formátu řetězce vráceného touto metodou. Při vyvolání ToString(String, IFormatProvider) metody volá metodu parametru IFormatProvider.GetFormatprovider
a předá jí Type objekt, který představuje NumberFormatInfo typ. Metoda GetFormat pak vrátí NumberFormatInfo objekt, který poskytuje informace pro formátování parametru value
, například symbol záporného znaménka, symbol oddělovače skupin nebo symbol desetinné čárky. Existují tři způsoby použití parametru provider
k poskytnutí informací o ToString(String, IFormatProvider) formátování metodě:
Můžete předat CultureInfo objekt, který představuje jazykovou verzi, která poskytuje informace o formátování. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace o číselném formátování pro danou jazykovou verzi.
Můžete předat skutečný NumberFormatInfo objekt, který poskytuje informace o číselném formátování. (Jeho implementace pouze GetFormat vrací sama sebe.)
Můžete předat vlastní objekt, který implementuje IFormatProvider. Jeho GetFormat metoda vytvoří instanci a vrátí NumberFormatInfo objekt, který poskytuje informace o formátování.
Pokud provider
je null
, formátování vráceného řetězce je založeno na objektu NumberFormatInfo aktuální jazykové verze.
Viz také
- Typy formátování v .NET
- Postupy: Vyplnění čísla úvodními nulami
- Standardní řetězce pro formátování čísel
- Vlastní řetězce číselného formátu
- Ukázka: .NET Core – nástroj pro formátování WinForms (C#)
- Ukázka: .NET Core WinForms Formatting Utility (Visual Basic)