UInt16.ToString Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.
Przeciążenia
ToString(IFormatProvider) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury. |
ToString(String) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu. |
ToString(String, IFormatProvider) |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu i informacji specyficznych dla kultury. |
ToString() |
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu. |
ToString(IFormatProvider)
- Źródło:
- UInt16.cs
- Źródło:
- UInt16.cs
- Źródło:
- UInt16.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury.
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
Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.
Zwraca
Ciąg reprezentujący wartość tego wystąpienia, która składa się z sekwencji cyfr od 0 do 9, bez znaku lub zer wiodących.
Implementuje
Przykłady
Poniższy przykład formatuje 16-bitową wartość całkowitą ze znakiem przy użyciu kilku dostawców formatu, w tym jednego dla niezmiennej kultury. Dane wyjściowe z przykładu pokazują, że sformatowany ciąg zwrócony przez metodę ToString(IFormatProvider) jest taki sam, niezależnie od dostawcy formatu.
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 };
UInt16 value = 18924;
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
// 18924 18924 18924
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 = 18924us
printfn $" {getName ci[0],12} {getName ci[1],12} {getName ci[2],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
// 18924 18924 18924
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 UInt16 = 18924
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
' 18924 18924 18924
Uwagi
Metoda ToString(IFormatProvider) formatuje UInt16 wartość w domyślnym formacie ("G" lub ogólnym) przy użyciu NumberFormatInfo obiektu określonej kultury. Jeśli chcesz określić inny format lub bieżącą kulturę, użyj innych przeciążeń ToString metody w następujący sposób:
Aby użyć formatu | Dla kultury | Używanie przeciążenia |
---|---|---|
Domyślny format ("G") | Domyślna (bieżąca) kultura | ToString() |
Określony format | Domyślna (bieżąca) kultura | ToString(String) |
Określony format | Określona kultura | ToString(String, IFormatProvider) |
Parametr provider
jest implementacją IFormatProvider . Metoda GetFormat zwraca NumberFormatInfo obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury. Jednak żadna z właściwości elementu NumberFormatInfo nie jest używana podczas formatowania za pomocą ogólnego specyfikatora formatu liczbowego ("G").
Zobacz też
Dotyczy
ToString(String)
- Źródło:
- UInt16.cs
- Źródło:
- UInt16.cs
- Źródło:
- UInt16.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu.
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
Ciąg formatu liczbowego.
Zwraca
Ciąg reprezentacja wartości tego wystąpienia określona przez format
.
Wyjątki
Parametr format
jest nieprawidłowy.
Przykłady
Poniższy przykład przedstawia 16-bitową niepodpisaną wartość całkowitą przy użyciu każdego standardowego ciągu formatu i niektórych ciągów formatu niestandardowego.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
ushort value = 21708;
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: 21708
// C: $21,708.00
// D3: 21708
// E2: 2.17E+004
// e3: 2.171e+004
// F: 21708.00
// N: 21,708.00
// P: 2,170,800.00 %
// X: 54CC
// 000000.0: 021708.0
// #.0: 21708.0
// 00000000;(0);**Zero**: 00021708
let value = 21708us
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: 21708
// C: $21,708.00
// D3: 21708
// E2: 2.17E+004
// e3: 2.171e+004
// F: 21708.00
// N: 21,708.00
// P: 2,170,800.00 %
// X: 54CC
// 000000.0: 021708.0
// #.0: 21708.0
// 00000000(0)**Zero**: 00021708
Imports System.Globalization
Module Example
Public Sub Main()
Dim value As UShort = 21708
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: 21708
' C: $21,708.00
' D3: 21708
' E2: 2.17E+004
' e3: 2.171e+004
' F: 21708.00
' N: 21,708.00
' P: 2,170,800.00 %
' X: 54CC
' 000000.0: 021708.0
' #.0: 21708.0
' 00000000;(0);**Zero**: 00021708
Uwagi
Metoda ToString(String) formatuje UInt16 wartość w określonym formacie przy użyciu obiektu reprezentującego NumberFormatInfo konwencje bieżącej kultury. Jeśli chcesz użyć domyślnego formatu ("G" lub ogólnego) lub określić inną kulturę, użyj innych przeciążeń ToString metody w następujący sposób:
Aby użyć formatu | Dla kultury | Używanie przeciążenia |
---|---|---|
Domyślny format ("G") | Domyślna (bieżąca) kultura | ToString() |
Domyślny format ("G") | Określona kultura | ToString(IFormatProvider) |
Określony format | Określona kultura | ToString(String, IFormatProvider) |
Parametr format
może być dowolnym prawidłowym standardowym specyfikatorem formatu liczbowego lub dowolną kombinacją niestandardowych specyfikatorów formatu liczbowego. Jeśli format
wartość jest równa String.Empty lub ma null
wartość , zwracana wartość bieżącego UInt16 obiektu jest formatowana za pomocą ogólnego specyfikatora formatu ("G"). Jeśli format
jest inną wartością FormatException, metoda zgłasza wartość .
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:
Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.
Aby uzyskać więcej informacji na temat obsługi formatowania na platformie .NET, zobacz Typy formatowania.
Format zwracanego ciągu jest określany przez NumberFormatInfo obiekt dla bieżącej kultury. W zależności od parametru format
ten obiekt kontroluje symbole, takie jak separator grupy i symbol punktu dziesiętnego w ciągu wyjściowym. Aby zapewnić informacje o formatowaniu dla kultur innych niż bieżąca kultura, wywołaj ToString(String, IFormatProvider) przeciążenie.
Zobacz też
Dotyczy
ToString(String, IFormatProvider)
- Źródło:
- UInt16.cs
- Źródło:
- UInt16.cs
- Źródło:
- UInt16.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu i informacji specyficznych dla kultury.
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
Ciąg formatu liczbowego.
- provider
- IFormatProvider
Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.
Zwraca
Ciąg reprezentujący wartość tego wystąpienia zgodnie z parametrami format
i provider
.
Implementuje
Wyjątki
Nazwa format
jest niepoprawna.
Przykłady
Poniższy przykład przedstawia 16-bitową niepodpisaną wartość całkowitą przy użyciu standardowych specyfikatorów formatu liczbowego i wielu określonych CultureInfo obiektów.
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"};
ushort value = 22042;
foreach (string specifier in specifiers)
{
foreach (CultureInfo culture in cultures)
Console.WriteLine("{0,2} format using {1} culture: {2, 16}",
specifier, culture.Name,
value.ToString(specifier, culture));
Console.WriteLine();
}
}
}
// The example displays the following output:
// G format using en-US culture: 22042
// G format using fr-FR culture: 22042
// G format using es-ES culture: 22042
//
// C format using en-US culture: $22,042.00
// C format using fr-FR culture: 22 042,00 €
// C format using es-ES culture: 22.042,00 €
//
// D4 format using en-US culture: 22042
// D4 format using fr-FR culture: 22042
// D4 format using es-ES culture: 22042
//
// E2 format using en-US culture: 2.20E+004
// E2 format using fr-FR culture: 2,20E+004
// E2 format using es-ES culture: 2,20E+004
//
// F format using en-US culture: 22042.00
// F format using fr-FR culture: 22042,00
// F format using es-ES culture: 22042,00
//
// N format using en-US culture: 22,042.00
// N format using fr-FR culture: 22 042,00
// N format using es-ES culture: 22.042,00
//
// P format using en-US culture: 2,204,200.00 %
// P format using fr-FR culture: 2 204 200,00 %
// P format using es-ES culture: 2.204.200,00 %
//
// X2 format using en-US culture: 561A
// X2 format using fr-FR culture: 561A
// X2 format using es-ES culture: 561A
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 = 22042us
for specifier in specifiers do
for culture in cultures do
printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 16}"
printfn ""
// The example displays the following output:
// G format using en-US culture: 22042
// G format using fr-FR culture: 22042
// G format using es-ES culture: 22042
//
// C format using en-US culture: $22,042.00
// C format using fr-FR culture: 22 042,00 €
// C format using es-ES culture: 22.042,00 €
//
// D4 format using en-US culture: 22042
// D4 format using fr-FR culture: 22042
// D4 format using es-ES culture: 22042
//
// E2 format using en-US culture: 2.20E+004
// E2 format using fr-FR culture: 2,20E+004
// E2 format using es-ES culture: 2,20E+004
//
// F format using en-US culture: 22042.00
// F format using fr-FR culture: 22042,00
// F format using es-ES culture: 22042,00
//
// N format using en-US culture: 22,042.00
// N format using fr-FR culture: 22 042,00
// N format using es-ES culture: 22.042,00
//
// P format using en-US culture: 2,204,200.00 %
// P format using fr-FR culture: 2 204 200,00 %
// P format using es-ES culture: 2.204.200,00 %
//
// X2 format using en-US culture: 561A
// X2 format using fr-FR culture: 561A
// X2 format using es-ES culture: 561A
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 UShort = 22042
For Each specifier As String In specifiers
For Each culture As CultureInfo In Cultures
Console.WriteLine("{0,2} format using {1} culture: {2, 16}", _
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: 22042
' G format using fr-FR culture: 22042
' G format using es-ES culture: 22042
'
' C format using en-US culture: $22,042.00
' C format using fr-FR culture: 22 042,00 €
' C format using es-ES culture: 22.042,00 €
'
' D4 format using en-US culture: 22042
' D4 format using fr-FR culture: 22042
' D4 format using es-ES culture: 22042
'
' E2 format using en-US culture: 2.20E+004
' E2 format using fr-FR culture: 2,20E+004
' E2 format using es-ES culture: 2,20E+004
'
' F format using en-US culture: 22042.00
' F format using fr-FR culture: 22042,00
' F format using es-ES culture: 22042,00
'
' N format using en-US culture: 22,042.00
' N format using fr-FR culture: 22 042,00
' N format using es-ES culture: 22.042,00
'
' P format using en-US culture: 2,204,200.00 %
' P format using fr-FR culture: 2 204 200,00 %
' P format using es-ES culture: 2.204.200,00 %
'
' X2 format using en-US culture: 561A
' X2 format using fr-FR culture: 561A
' X2 format using es-ES culture: 561A
Uwagi
Metoda ToString(String, IFormatProvider) formatuje UInt16 wartość w określonym formacie przy użyciu NumberFormatInfo obiektu określonej kultury. Jeśli chcesz użyć domyślnych ustawień formatu lub kultury, użyj innych przeciążeń ToString metody w następujący sposób:
Aby użyć formatu | Dla kultury | Używanie przeciążenia |
---|---|---|
Domyślny format ("G") | Domyślna (bieżąca) kultura | ToString() |
Domyślny format ("G") | Określona kultura | ToString(IFormatProvider) |
Określony format | Domyślna (bieżąca) kultura | ToString(String) |
Parametr format
może być dowolnym prawidłowym standardowymi ciągami formatu liczbowego lub dowolną kombinacją niestandardowych ciągów formatu liczbowego. Jeśli format
wartość jest równa String.Empty lub ma null
wartość , zwracana wartość bieżącego UInt16 obiektu jest formatowana za pomocą ogólnego specyfikatora formatu ("G"). Jeśli format
jest inną wartością FormatException, metoda zgłasza wartość .
Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:
Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.
Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.
Parametr provider
jest implementacją IFormatProvider . Metoda GetFormat zwraca NumberFormatInfo obiekt, który dostarcza informacje specyficzne dla kultury dotyczące formatu ciągu zwróconego przez tę metodę. Po wywołaniu ToString(String, IFormatProvider) metody wywołuje provider
metodę parametru IFormatProvider.GetFormat i przekazuje go Type do obiektu reprezentującego NumberFormatInfo typ. Następnie GetFormat metoda zwraca NumberFormatInfo obiekt, który dostarcza informacje dotyczące formatowania bieżącej UInt16 wartości, takiej jak symbol separatora grupy lub symbol separatora dziesiętnego. Istnieją trzy sposoby użycia parametru provider
do podawania informacji o formatowaniu do ToString(String, IFormatProvider) metody :
Można przekazać obiekt reprezentujący kulturę CultureInfo dostarczającą informacje o formatowaniu. Metoda GetFormat zwraca NumberFormatInfo obiekt, który dostarcza informacje o formatowaniu liczbowym dla tej kultury.
Można przekazać rzeczywisty NumberFormatInfo obiekt, który udostępnia informacje o formatowaniu liczbowym. (Jego implementacja GetFormat samego zwraca się).
Można przekazać obiekt niestandardowy, który implementuje IFormatProviderelement . Metoda GetFormat tworzy wystąpienie i zwraca NumberFormatInfo obiekt, który dostarcza informacje o formatowaniu.
Jeśli provider
parametr ma null
wartość , formatowanie zwracanego ciągu jest oparte na NumberFormatInfo obiekcie bieżącej kultury.
Zobacz też
- Parse(String)
- Typy formatowania na platformie .NET
- Instrukcje: Uzupełnianie liczby zerami wiodącymi
- Przykład: .NET Core WinForms Formatting Utility (C#)
- Przykład: .NET Core WinForms Formatting Utility (Visual Basic)
Dotyczy
ToString()
- Źródło:
- UInt16.cs
- Źródło:
- UInt16.cs
- Źródło:
- UInt16.cs
Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Zwraca
Ciąg reprezentujący wartość tego wystąpienia, która składa się z sekwencji cyfr od 0 do 9, bez znaku lub zer wiodących.
Przykłady
Poniższy przykład przedstawia UInt16 wartość przy użyciu metody domyślnej ToString() . Wyświetla również reprezentacje UInt16 ciągu wartości, która wynika z używania niektórych standardowych specyfikatorów formatu. W przykładach jest używana konwencja formatowania kultury en-US.
using System;
public class Example
{
public static void Main()
{
ushort value = 16324;
// 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,12}",
format, value.ToString(format));
}
}
// The example displays the following output:
// 16324
//
// G format specifier: 16324
// C format specifier: $16,324.00
// D format specifier: 16324
// F format specifier: 16324.00
// N format specifier: 16,324.00
// X format specifier: 3FC4
let value = 16324us
// 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,12}"
// The example displays the following output:
// 16324
//
// G format specifier: 16324
// C format specifier: $16,324.00
// D format specifier: 16324
// F format specifier: 16324.00
// N format specifier: 16,324.00
// X format specifier: 3FC4
Module Example
Public Sub Main()
Dim value As UInt16 = 16324
' 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,12}", _
format, value.ToString(format))
Next
End Sub
End Module
' The example displays the following output:
' 16324
'
' G format specifier: 16324
' C format specifier: $16,324.00
' D format specifier: 16324
' F format specifier: 16324.00
' N format specifier: 16,324.00
' X format specifier: 3FC4
Uwagi
Metoda ToString() formatuje UInt16 wartość w domyślnym formacie ("G" lub ogólnym) przy użyciu NumberFormatInfo obiektu bieżącej kultury. Jeśli chcesz określić inny format lub kulturę, użyj innych przeciążeń ToString metody w następujący sposób:
Aby użyć formatu | Dla kultury | Używanie przeciążenia |
---|---|---|
Domyślny format ("G") | Określona kultura | ToString(IFormatProvider) |
Określony format | Domyślna (bieżąca) kultura | ToString(String) |
Określony format | Określona kultura | ToString(String, IFormatProvider) |