UInt32.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(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řevede číselnou hodnotu této instance na ekvivalentní řetězcové vyjádření pomocí zadané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() |
Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření. |
ToString(IFormatProvider)
- Zdroj:
- UInt32.cs
- Zdroj:
- UInt32.cs
- Zdroj:
- UInt32.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é vyjádření hodnoty této instance, která se skládá z posloupnosti číslic v rozsahu od 0 do 9, bez znaménka nebo počátečních nul.
Implementuje
Příklady
Následující příklad formátuje 16bitovou celočíselnou hodnotu se signýmým kódem pomocí několika zprostředkovatelů formátu, včetně jednoho pro invariantní jazykovou verzi. Výstup z příkladu ukazuje, že formátovaný řetězec vrácený metodou ToString(IFormatProvider) je stejný bez ohledu na poskytovatele formátu.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define an array of CultureInfo objects.
CultureInfo[] ci = { new CultureInfo("en-US"),
new CultureInfo("fr-FR"),
CultureInfo.InvariantCulture };
uint value = 1870924;
Console.WriteLine(" {0,12} {1,12} {2,12}",
GetName(ci[0]), GetName(ci[1]), GetName(ci[2]));
Console.WriteLine(" {0,12} {1,12} {2,12}",
value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));
}
private static string GetName(CultureInfo ci)
{
if (ci.Equals(CultureInfo.InvariantCulture))
return "Invariant";
else
return ci.Name;
}
}
// The example displays the following output:
// en-US fr-FR Invariant
// 1870924 1870924 1870924
open System.Globalization
let getName (ci: CultureInfo) =
if ci.Equals CultureInfo.InvariantCulture then
"Invariant"
else
ci.Name
// Define an array of CultureInfo objects.
let ci =
[| CultureInfo "en-US"
CultureInfo "fr-FR"
CultureInfo.InvariantCulture |]
let value = 1870924u
printfn $" {getName ci[0],12} {getName ci[1],12} {getName ci[3],12}"
printfn $" {value.ToString ci[0],12} {value.ToString ci[1],12} {value.ToString ci[2],12}"
// The example displays the following output:
// en-US fr-FR Invariant
// 1870924 1870924 1870924
Imports System.Globalization
Module Example
Public Sub Main()
' Define an array of CultureInfo objects.
Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
New CultureInfo("fr-FR"), _
CultureInfo.InvariantCulture }
Dim value As UInteger = 1870924
Console.WriteLine(" {0,12} {1,12} {2,12}", _
GetName(ci(0)), GetName(ci(1)), GetName(ci(2)))
Console.WriteLine(" {0,12} {1,12} {2,12}", _
value.ToString(ci(0)), value.ToString(ci(1)), value.ToString(ci(2)))
End Sub
Private Function GetName(ci As CultureInfo) As String
If ci.Equals(CultureInfo.InvariantCulture) Then
Return "Invariant"
Else
Return ci.Name
End If
End Function
End Module
' The example displays the following output:
' en-US fr-FR Invariant
' 1870924 1870924 1870924
Poznámky
Metoda ToString(IFormatProvider) formátuje UInt32 hodnotu ve výchozím ("G" nebo obecném) formátu pomocí objektu NumberFormatInfo 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 o formátování specifické pro jazykovou verzi. Při formátování pomocí obecného specifikátoru číselného formátu ("G") se však nepoužívají žádné vlastnosti objektu NumberFormatInfo .
Viz také
Platí pro
ToString(String)
- Zdroj:
- UInt32.cs
- Zdroj:
- UInt32.cs
- Zdroj:
- UInt32.cs
Převede číselnou hodnotu této instance na ekvivalentní řetězcové vyjádření pomocí zadané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
Řetězec číselného formátu.
Návraty
Řetězcové vyjádření hodnoty této instance určené parametrem format
.
Výjimky
Parametr format
je neplatný.
Příklady
Následující příklad zobrazí 32bitovou celočíselnou hodnotu bez znaménka pomocí jednotlivých řetězců standardního formátu a některých řetězců vlastního formátu.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
uint value = 2179608;
string[] specifiers = { "G", "C", "D3", "E2", "e3", "F",
"N", "P", "X", "000000.0", "#.0",
"00000000;(0);**Zero**" };
foreach (string specifier in specifiers)
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
}
}
// The example displays the following output:
// G: 2179608
// C: $2,179,608.00
// D3: 2179608
// E2: 2.18E+006
// e3: 2.180e+006
// F: 2179608.00
// N: 2,179,608.00
// P: 217,960,800.00 %
// X: 214218
// 000000.0: 2179608.0
// #.0: 2179608.0
// 00000000;(0);**Zero**: 02179608
let value = 2179608u
let specifiers =
[| "G"; "C"; "D3"; "E2"; "e3"; "F"
"N"; "P"; "X"; "000000.0"; "#.0"
"00000000(0)**Zero**" |]
for specifier in specifiers do
printfn $"{specifier}: {value.ToString specifier}"
// The example displays the following output:
// G: 2179608
// C: $2,179,608.00
// D3: 2179608
// E2: 2.18E+006
// e3: 2.180e+006
// F: 2179608.00
// N: 2,179,608.00
// P: 217,960,800.00 %
// X: 214218
// 000000.0: 2179608.0
// #.0: 2179608.0
// 00000000(0)**Zero**: 02179608
Imports System.Globalization
Module Example
Public Sub Main()
Dim value As UInteger = 2179608
Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
"N", "P", "X", "000000.0", "#.0", _
"00000000;(0);**Zero**" }
For Each specifier As String In specifiers
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next
End Sub
End Module
' The example displays the following output:
' G: 2179608
' C: $2,179,608.00
' D3: 2179608
' E2: 2.18E+006
' e3: 2.180e+006
' F: 2179608.00
' N: 2,179,608.00
' P: 217,960,800.00 %
' X: 214218
' 000000.0: 2179608.0
' #.0: 2179608.0
' 00000000;(0);**Zero**: 02179608
Poznámky
Metoda ToString(String) formátuje UInt32 hodnotu v zadaném formátu pomocí objektu NumberFormatInfo , který představuje konvence 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ý řetězec standardního číselného formátu nebo libovolná kombinace řetězců vlastního číselného formátu. Pokud format
je hodnota String.Empty rovna nebo je null
, návratová hodnota aktuálního UInt32 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í.
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 oddělovač skupin a symbol desetinné čárky ve výstupním řetězci. Chcete-li poskytnout informace o formátování pro jiné jazykové verze než aktuální jazykovou verzi, zavolejte ToString(String, IFormatProvider) přetížení.
Viz také
Platí pro
ToString(String, IFormatProvider)
- Zdroj:
- UInt32.cs
- Zdroj:
- UInt32.cs
- Zdroj:
- UInt32.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
Řetězec číselného formátu.
- provider
- IFormatProvider
Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi k této instanci.
Návraty
Řetězcové vyjádření hodnoty této instance podle a format
provider
.
Implementuje
Výjimky
Parametr format
je neplatný.
Příklady
Následující příklad zobrazí 32bitovou celočíselnou hodnotu bez znaménka pomocí specifikátorů standardního čí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") };
string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"};
uint value = 2222402;
foreach (string specifier in specifiers)
{
foreach (CultureInfo culture in cultures)
Console.WriteLine("{0,2} format using {1} culture: {2, 18}",
specifier, culture.Name,
value.ToString(specifier, culture));
Console.WriteLine();
}
}
}
// The example displays the following output:
// G format using en-US culture: 2222402
// G format using fr-FR culture: 2222402
// G format using es-ES culture: 2222402
//
// C format using en-US culture: $2,222,402.00
// C format using fr-FR culture: 2 222 402,00 €
// C format using es-ES culture: 2.222.402,00 €
//
// D4 format using en-US culture: 2222402
// D4 format using fr-FR culture: 2222402
// D4 format using es-ES culture: 2222402
//
// E2 format using en-US culture: 2.22E+006
// E2 format using fr-FR culture: 2,22E+006
// E2 format using es-ES culture: 2,22E+006
//
// F format using en-US culture: 2222402.00
// F format using fr-FR culture: 2222402,00
// F format using es-ES culture: 2222402,00
//
// N format using en-US culture: 2,222,402.00
// N format using fr-FR culture: 2 222 402,00
// N format using es-ES culture: 2.222.402,00
//
// P format using en-US culture: 222,240,200.00 %
// P format using fr-FR culture: 222 240 200,00 %
// P format using es-ES culture: 222.240.200,00 %
//
// X2 format using en-US culture: 21E942
// X2 format using fr-FR culture: 21E942
// X2 format using es-ES culture: 21E942
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 specifiers =
[| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |]
let value = 2222402
for specifier in specifiers do
for culture in cultures do
printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 18}"
printfn ""
// The example displays the following output:
// G format using en-US culture: 2222402
// G format using fr-FR culture: 2222402
// G format using es-ES culture: 2222402
//
// C format using en-US culture: $2,222,402.00
// C format using fr-FR culture: 2 222 402,00 €
// C format using es-ES culture: 2.222.402,00 €
//
// D4 format using en-US culture: 2222402
// D4 format using fr-FR culture: 2222402
// D4 format using es-ES culture: 2222402
//
// E2 format using en-US culture: 2.22E+006
// E2 format using fr-FR culture: 2,22E+006
// E2 format using es-ES culture: 2,22E+006
//
// F format using en-US culture: 2222402.00
// F format using fr-FR culture: 2222402,00
// F format using es-ES culture: 2222402,00
//
// N format using en-US culture: 2,222,402.00
// N format using fr-FR culture: 2 222 402,00
// N format using es-ES culture: 2.222.402,00
//
// P format using en-US culture: 222,240,200.00 %
// P format using fr-FR culture: 222 240 200,00 %
// P format using es-ES culture: 222.240.200,00 %
//
// X2 format using en-US culture: 21E942
// X2 format using fr-FR culture: 21E942
// X2 format using es-ES culture: 21E942
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 specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}
Dim value As UInteger = 2222402
For Each specifier As String In specifiers
For Each culture As CultureInfo In Cultures
Console.WriteLine("{0,2} format using {1} culture: {2, 18}", _
specifier, culture.Name, _
value.ToString(specifier, culture))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' G format using en-US culture: 2222402
' G format using fr-FR culture: 2222402
' G format using es-ES culture: 2222402
'
' C format using en-US culture: $2,222,402.00
' C format using fr-FR culture: 2 222 402,00 €
' C format using es-ES culture: 2.222.402,00 €
'
' D4 format using en-US culture: 2222402
' D4 format using fr-FR culture: 2222402
' D4 format using es-ES culture: 2222402
'
' E2 format using en-US culture: 2.22E+006
' E2 format using fr-FR culture: 2,22E+006
' E2 format using es-ES culture: 2,22E+006
'
' F format using en-US culture: 2222402.00
' F format using fr-FR culture: 2222402,00
' F format using es-ES culture: 2222402,00
'
' N format using en-US culture: 2,222,402.00
' N format using fr-FR culture: 2 222 402,00
' N format using es-ES culture: 2.222.402,00
'
' P format using en-US culture: 222,240,200.00 %
' P format using fr-FR culture: 222 240 200,00 %
' P format using es-ES culture: 222.240.200,00 %
'
' X2 format using en-US culture: 21E942
' X2 format using fr-FR culture: 21E942
' X2 format using es-ES culture: 21E942
Poznámky
Metoda ToString(String, IFormatProvider) formátuje UInt32 hodnotu v zadaném formátu pomocí objektu NumberFormatInfo zadané jazykové verze. Pokud chcete použít výchozí formát nebo nastavení jazykové verze ToString , použijte další přetížení 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ý řetězec standardního číselného formátu nebo libovolná kombinace řetězců vlastního číselného formátu. Pokud format
je hodnota String.Empty rovna nebo je null
, návratová hodnota aktuálního UInt32 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 formátování 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í aktuální UInt32 hodnoty, například 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é
- Parse(String)
- Typy formátování v .NET
- Postupy: Vyplnění čísla úvodními nulami
- Ukázka: .NET Core – nástroj pro formátování WinForms (C#)
- Ukázka: .NET Core WinForms Formatting Utility (Visual Basic)
Platí pro
ToString()
- Zdroj:
- UInt32.cs
- Zdroj:
- UInt32.cs
- Zdroj:
- UInt32.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á z posloupnosti číslic v rozsahu od 0 do 9, bez znaménka nebo počátečních nul.
Příklady
Následující příklad zobrazí UInt32 hodnotu pomocí výchozí ToString() metody. Zobrazuje také řetězcové reprezentace hodnoty, která je výsledkem použití některých standardních UInt32 specifikátorů formátu. Příklady jsou zobrazeny pomocí konvencí formátování jazykové verze en-US.
using System;
public class Example
{
public static void Main()
{
uint value = 1632490;
// Display value using default ToString method.
Console.WriteLine(value.ToString());
Console.WriteLine();
// Define an array of format specifiers.
string[] formats = { "G", "C", "D", "F", "N", "X" };
// Display value using the standard format specifiers.
foreach (string format in formats)
Console.WriteLine("{0} format specifier: {1,16}",
format, value.ToString(format));
}
}
// The example displays the following output:
// 1632490
//
// G format specifier: 1632490
// C format specifier: $1,632,490.00
// D format specifier: 1632490
// F format specifier: 1632490.00
// N format specifier: 1,632,490.00
// X format specifier: 18E8EA
let value = 1632490u
// Display value using default ToString method.
printfn $"{value.ToString()}\n"
// Define an array of format specifiers.
let formats = [| "G"; "C"; "D"; "F"; "N"; "X" |]
// Display value using the standard format specifiers.
for format in formats do
printfn $"{format} format specifier: {value.ToString format,16}"
// The example displays the following output:
// 1632490
//
// G format specifier: 1632490
// C format specifier: $1,632,490.00
// D format specifier: 1632490
// F format specifier: 1632490.00
// N format specifier: 1,632,490.00
// X format specifier: 18E8EA
Module Example
Public Sub Main()
Dim value As UInteger = 1632490
' Display value using default ToString method.
Console.WriteLine(value.ToString())
Console.WriteLine()
' Define an array of format specifiers.
Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
' Display value using the standard format specifiers.
For Each format As String In formats
Console.WriteLine("{0} format specifier: {1,16}", _
format, value.ToString(format))
Next
End Sub
End Module
' The example displays the following output:
' 1632490
'
' G format specifier: 1632490
' C format specifier: $1,632,490.00
' D format specifier: 1632490
' F format specifier: 1632490.00
' N format specifier: 1,632,490.00
' X format specifier: 18E8EA
Poznámky
Metoda ToString() formátuje UInt32 hodnotu ve výchozím formátu ("G" nebo obecné) pomocí objektu NumberFormatInfo 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) |
Viz také
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro