Int16.ToString Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation.
Överlagringar
| Name | Description |
|---|---|
| ToString(IFormatProvider) |
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation med den angivna kulturspecifika formatinformationen. |
| ToString(String, IFormatProvider) |
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation med det angivna formatet och kulturspecifik formateringsinformation. |
| ToString(String) |
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation med det angivna formatet. |
| ToString() |
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation. |
ToString(IFormatProvider)
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation med den angivna kulturspecifika formatinformationen.
public:
virtual System::String ^ ToString(IFormatProvider ^ provider);
public:
System::String ^ ToString(IFormatProvider ^ provider);
public string ToString(IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String
Parametrar
- provider
- IFormatProvider
En IFormatProvider som tillhandahåller kulturspecifik formateringsinformation.
Returer
Strängrepresentationen av värdet för den här instansen som anges av provider.
Implementeringar
Exempel
I följande exempel itereras en matris med Int16 värden och var och en av dem visas i konsolen genom att anropa Int16.ToString(IFormatProvider) metoden med olika formatproviders. På grund av den enkla formatering som definieras av standardformatsspecificeraren "G" är de formaterade strängar som skapas för varje Int16 värde identiska oavsett värdet för parametern provider .
short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"),
new CultureInfo("fr-fr"),
new CultureInfo("de-de"),
new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
foreach (CultureInfo provider in providers)
{
Console.Write("{0, 6} ({1}) ",
int16Value.ToString(provider),
provider.Name);
}
Console.WriteLine();
}
// The example displays the following output to the console:
// -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
// 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
// 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
// 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
let numbers = [ -23092s; 0s; 14894s; Int16.MaxValue ]
let providers =
[ CultureInfo "en-us"
CultureInfo "fr-fr"
CultureInfo "de-de"
CultureInfo "es-es" ]
for int16Value in numbers do
for provider in providers do
printf $"{int16Value.ToString provider, 6} ({provider.Name}) "
printfn ""
// The example displays the following output to the console:
// -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
// 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
// 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
// 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
New CultureInfo("fr-fr"), _
New CultureInfo("de-de"), _
New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
For Each provider As CultureInfo In providers
Console.Write("{0, 6} ({1}) ", _
int16Value.ToString(provider), _
provider.Name)
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
' -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
' 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
' 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
' 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
Kommentarer
Metoden ToString(IFormatProvider) formaterar ett Int16 värde i standardformatet ("G" eller allmänt) med hjälp av objektet för NumberFormatInfo en angiven kultur. Om du vill ange ett annat format eller den aktuella kulturen använder du de andra överlagringarna av ToString metoden enligt följande:
| Så här använder du format | För kultur | Använd överlagringen |
|---|---|---|
| Standardformat ("G") | Standardkultur (aktuell) | ToString() |
| Ett specifikt format | Standardkultur (aktuell) | ToString(String) |
| Ett specifikt format | En specifik kultur | ToString(String, IFormatProvider) |
.NET ger omfattande formateringsstöd, vilket beskrivs mer detaljerat i följande formateringsämnen:
Mer information om numeriska formatspecificerare finns i Standard numeriska formatsträngar och anpassade numeriska formatsträngar.
Mer information om formatering finns i Formateringstyper.
Parametern provider är en IFormatProvider implementering vars IFormatProvider.GetFormat metod returnerar ett NumberFormatInfo objekt.
provider Vanligtvis är ett NumberFormatInfo objekt eller ett CultureInfo objekt. Objektet NumberFormatInfo innehåller kulturspecifik information om formatet på strängen som returneras av den här metoden. Om provider är nullformateras den här instansen NumberFormatInfo med objektet för den aktuella kulturen.
Se även
Gäller för
ToString(String, IFormatProvider)
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation med det angivna formatet och kulturspecifik formateringsinformation.
public:
virtual System::String ^ ToString(System::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
Parametrar
- format
- String
En numerisk formatsträng.
- provider
- IFormatProvider
Ett objekt som tillhandahåller kulturspecifik formateringsinformation.
Returer
Strängrepresentationen av värdet för den här instansen som anges av format och provider.
Implementeringar
Exempel
I följande exempel visas ett värde med var och en Int16 av standardformatsträngarna som stöds i fyra olika kulturer.
Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1",
"P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"),
new CultureInfo("fr-fr"),
new CultureInfo("de-de"),
new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1],
providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
// Display the value for each provider on the same line.
Console.Write("{0,-12}", format);
foreach (CultureInfo provider in providers)
{
Console.Write("{0,12} ",
value.ToString(format, provider));
}
Console.WriteLine();
}
// The example displays the following output to the console:
// en-US fr-FR de-DE es-ES
//
// C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
// D6 014603 014603 014603 014603
// e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
// E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
// F1 14603.0 14603,0 14603,0 14603,0
// G 14603 14603 14603 14603
// N1 14,603.0 14 603,0 14.603,0 14.603,0
// P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
// X4 390B 390B 390B 390B
// 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
// ##000.0 14603.0 14603,0 14603,0 14603,0
let value = 14603
let formats =
[ "C"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
"P0"; "X4"; "000000.0000"; "##000.0" ]
let providers =
[ CultureInfo "en-us"
CultureInfo "fr-fr"
CultureInfo "de-de"
CultureInfo "es-es" ]
// Display header.
printfn $"{providers[0],24}{providers[1],14}{providers[2],14}{providers[3],14}\n"
// Display a value using each format string.
for format in formats do
// Display the value for each provider on the same line.
printf $"{format,-12}"
for provider in providers do
printf $"{value.ToString(format, provider),12} "
printfn ""
// The example displays the following output to the console:
// en-US fr-FR de-DE es-ES
//
// C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
// D6 014603 014603 014603 014603
// e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
// E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
// F1 14603.0 14603,0 14603,0 14603,0
// G 14603 14603 14603 14603
// N1 14,603.0 14 603,0 14.603,0 14.603,0
// P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
// X4 390B 390B 390B 390B
// 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
// ##000.0 14603.0 14603,0 14603,0 14603,0
Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
"P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
New CultureInfo("fr-fr"), _
New CultureInfo("de-de"), _
New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
providers(2), providers(3))
Console.WriteLine()
' Display a value using each format string.
For Each format As String In formats
' Display the value for each provider on the same line.
Console.Write("{0,-12}", format)
For Each provider As CultureInfo In providers
Console.Write("{0,12} ", _
value.ToString(format, provider))
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
' en-US fr-FR de-DE es-ES
'
' C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
' D6 014603 014603 014603 014603
' e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
' E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
' F1 14603.0 14603,0 14603,0 14603,0
' G 14603 14603 14603 14603
' N1 14,603.0 14 603,0 14.603,0 14.603,0
' P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
' X4 390B 390B 390B 390B
' 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
' ##000.0 14603.0 14603,0 14603,0 14603,0
Kommentarer
Metoden ToString(String, IFormatProvider) formaterar ett Int16 värde i ett angivet format med hjälp av objektet för NumberFormatInfo en angiven kultur. Om du vill använda standardformat- eller kulturinställningar använder du de andra överlagringarna av ToString metoden enligt följande:
| Så här använder du format | För kultur | Använd överlagringen |
|---|---|---|
| Standardformat ("G") | Standardkultur (aktuell) | ToString() |
| Standardformat ("G") | En specifik kultur | ToString(IFormatProvider) |
| Ett specifikt format | Standardkultur (aktuell) | ToString(String) |
Parametern format kan vara antingen en standardsträng eller en anpassad numerisk formatsträng. Alla numeriska standardformatsträngar förutom "R" (eller "r") stöds, liksom alla anpassade numeriska formattecken. Om format är null eller en tom sträng (") formateras strängen som returneras av den här metoden med den allmänna numeriska formatspecificeraren ("G").
.NET ger omfattande formateringsstöd, vilket beskrivs mer detaljerat i följande formateringsämnen:
Mer information om numeriska formatspecificerare finns i Standard numeriska formatsträngar och anpassade numeriska formatsträngar.
Mer information om formatering finns i Formateringstyper.
Parametern provider är en IFormatProvider implementering. Metoden GetFormat returnerar ett NumberFormatInfo objekt som innehåller kulturspecifik information om formatet på strängen som returneras av den här metoden. Objektet som implementerar IFormatProvider kan vara något av följande:
Ett CultureInfo objekt som representerar kulturen vars formateringsregler ska användas.
Ett NumberFormatInfo objekt som innehåller specifik numerisk formateringsinformation för det här värdet.
Ett anpassat objekt som implementerar IFormatProvider.
Om provider är null, eller om ett NumberFormatInfo objekt inte kan hämtas från provider, formateras returvärdet med NumberFormatInfo för den aktuella kulturen.
Se även
- Parse(String)
- Formateringstyper i .NET
- Standardsträngar med numeriskt format
- Anpassade numeriska formatsträngar
- Instruktioner: Lägg till ett tal med inledande nollor
- Exempel: Formateringsverktyget för .NET Core WinForms (C#)
- Exempel: Formateringsverktyget för .NET Core WinForms (Visual Basic)
Gäller för
ToString(String)
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation med det angivna formatet.
public:
System::String ^ ToString(System::String ^ format);
public string ToString(string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String
Parametrar
- format
- String
En numerisk formatsträng.
Returer
Strängrepresentationen av värdet för den här instansen som anges av format.
Exempel
I följande exempel initieras två Int16 värden och de visas i konsolen med var och en av standardformatsträngarna som stöds och flera anpassade formatsträngar. Exemplet körs med en-US som aktuell kultur.
Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1",
"P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
Console.WriteLine("'{0,2}' format specifier: {1,17} {2,17}",
format,
values[0].ToString(format),
values[1].ToString(format));
}
// The example displays the following output to the console:
// 'C4' format specifier: ($23,805.0000) $32,194.0000
// 'D6' format specifier: -023805 032194
// 'e1' format specifier: -2.4e+004 3.2e+004
// 'E2' format specifier: -2.38E+004 3.22E+004
// 'F1' format specifier: -23805.0 32194.0
// ' G' format specifier: -23805 32194
// 'N1' format specifier: -23,805.0 32,194.0
// 'P0' format specifier: -2,380,500 % 3,219,400 %
// 'X4' format specifier: A303 7DC2
// '000000.0000' format specifier: -023805.0000 032194.0000
// '##000.0' format specifier: -23805.0 32194.0
let values = [| -23805s; 32194s |]
let formats =
[ "C4"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
"P0"; "X4"; "000000.0000"; "##000.0" ]
for format in formats do
printfn $"'{format,2}' format specifier: {values[0].ToString format,17} {values[1].ToString format,17}"
// The example displays the following output to the console:
// 'C4' format specifier: ($23,805.0000) $32,194.0000
// 'D6' format specifier: -023805 032194
// 'e1' format specifier: -2.4e+004 3.2e+004
// 'E2' format specifier: -2.38E+004 3.22E+004
// 'F1' format specifier: -23805.0 32194.0
// ' G' format specifier: -23805 32194
// 'N1' format specifier: -23,805.0 32,194.0
// 'P0' format specifier: -2,380,500 % 3,219,400 %
// 'X4' format specifier: A303 7DC2
// '000000.0000' format specifier: -023805.0000 032194.0000
// '##000.0' format specifier: -23805.0 32194.0
Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
"P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
Console.WriteLine("'{0,2}' format specifier: {1,17} {2,17}", _
format, _
values(0).ToString(format), _
values(1).ToString(format))
Next
' The example displays the following output to the console:
' 'C4' format specifier: ($23,805.0000) $32,194.0000
' 'D6' format specifier: -023805 032194
' 'e1' format specifier: -2.4e+004 3.2e+004
' 'E2' format specifier: -2.38E+004 3.22E+004
' 'F1' format specifier: -23805.0 32194.0
' ' G' format specifier: -23805 32194
' 'N1' format specifier: -23,805.0 32,194.0
' 'P0' format specifier: -2,380,500 % 3,219,400 %
' 'X4' format specifier: A303 7DC2
' '000000.0000' format specifier: -023805.0000 032194.0000
' '##000.0' format specifier: -23805.0 32194.0
Kommentarer
Metoden ToString(String) formaterar ett Int16 värde i ett angivet format med hjälp av ett NumberFormatInfo objekt som representerar den aktuella kulturens konventioner. Om du vill använda standardformatet ("G" eller allmänt) eller ange en annan kultur använder du de andra överlagringarna av ToString metoden enligt följande:
| Så här använder du format | För kultur | Använd överlagringen |
|---|---|---|
| Standardformat ("G") | Standardkultur (aktuell) | ToString() |
| Standardformat ("G") | En specifik kultur | ToString(IFormatProvider) |
| Ett specifikt format | En specifik kultur | ToString(String, IFormatProvider) |
Parametern format kan vara antingen en standardsträng eller en anpassad numerisk formatsträng. Alla numeriska standardformatsträngar förutom "R" (eller "r") stöds, liksom alla anpassade numeriska formattecken. Om format är null eller en tom sträng formateras returvärdet för den här instansen med den allmänna numeriska formatspecificeraren ("G").
.NET ger omfattande formateringsstöd, vilket beskrivs mer detaljerat i följande formateringsämnen:
Mer information om numeriska formatspecificerare finns i Standard numeriska formatsträngar och anpassade numeriska formatsträngar.
Mer information om formatering finns i Formateringstyper.
Returvärdet för den här instansen NumberFormatInfo formateras med för den aktuella kulturen.
Se även
- Parse(String)
- String
- Formateringstyper i .NET
- Standardsträngar med numeriskt format
- Anpassade numeriska formatsträngar
- Instruktioner: Lägg till ett tal med inledande nollor
Gäller för
ToString()
Konverterar det numeriska värdet för den här instansen till motsvarande strängrepresentation.
public:
override System::String ^ ToString();
public override string ToString();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Returer
Strängrepresentationen av värdet för den här instansen, som består av ett minustecken om värdet är negativt, och en sekvens med siffror mellan 0 och 9 utan inledande nollor.
Exempel
I följande exempel används ToString() metoden för att visa en matris med Int16 värden i konsolen.
short[] numbers = {0, 14624, 13982, short.MaxValue,
short.MinValue, -16667};
foreach (short number in numbers)
{
Console.WriteLine(number.ToString());
}
// The example displays the following output to the console:
// 0
// 14624
// 13982
// 32767
// -32768
// -16667
let numbers = [ 0s; 14624s; 13982s; Int16.MaxValue; Int16.MinValue; -16667s ]
for number in numbers do
printfn $"{number.ToString()}"
// The example displays the following output to the console:
// 0
// 14624
// 13982
// 32767
// -32768
// -16667
Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
Short.MinValue, -16667}
For Each number As Short In numbers
Console.WriteLine(number.ToString())
Next
' The example displays the following output to the console:
' 0
' 14624
' 13982
' 32767
' -32768
' -16667
Kommentarer
Metoden ToString() formaterar ett Int16 värde i standardformatet ("G" eller allmänt) med hjälp NumberFormatInfo av objektet för den aktuella kulturen. Om du vill ange ett annat format eller en annan kultur använder du de andra överlagringarna av ToString metoden enligt följande:
| Så här använder du format | För kultur | Använd överlagringen |
|---|---|---|
| Standardformat ("G") | En specifik kultur | ToString(IFormatProvider) |
| Ett specifikt format | Standardkultur (aktuell) | ToString(String) |
| Ett specifikt format | En specifik kultur | ToString(String, IFormatProvider) |
.NET ger omfattande formateringsstöd, vilket beskrivs mer detaljerat i följande formateringsämnen:
Mer information om numeriska formatspecificerare finns i Standard numeriska formatsträngar och anpassade numeriska formatsträngar.
Mer information om formatering finns i Formateringstyper.