Int16.ToString Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.
Überlädt
ToString() |
Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. |
ToString(IFormatProvider) |
Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung. |
ToString(String) |
Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats. |
ToString(String, IFormatProvider) |
Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung. |
ToString()
- Quelle:
- Int16.cs
- Quelle:
- Int16.cs
- Quelle:
- Int16.cs
Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.
public:
override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz, die aus einem Minuszeichen, sofern die Zahl negativ ist, und einer Folge von Ziffern zwischen 0 bis 9 ohne führende Nullen besteht.
Beispiele
Im folgenden Beispiel wird die ToString() -Methode verwendet, um ein Array von Int16 Werten in der Konsole anzuzeigen.
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
Hinweise
Die ToString() -Methode formatiert einen Int16 Wert im Standardformat ("G" oder allgemein), indem das NumberFormatInfo Objekt der aktuellen Kultur verwendet wird. Wenn Sie ein anderes Format oder eine andere Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString Methode wie folgt:
So verwenden Sie das Format | Für Kultur | Verwenden der Überladung |
---|---|---|
Standardformat ("G") | Eine bestimmte Kultur | ToString(IFormatProvider) |
Ein bestimmtes Format | Standardkultur (aktuelle Kultur) | ToString(String) |
Ein bestimmtes Format | Eine bestimmte Kultur | ToString(String, IFormatProvider) |
.NET bietet umfangreiche Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.
Weitere Informationen
Gilt für:
ToString(IFormatProvider)
- Quelle:
- Int16.cs
- Quelle:
- Int16.cs
- Quelle:
- Int16.cs
Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
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
Parameter
- provider
- IFormatProvider
Ein IFormatProvider, der kulturabhängige Formatierungsinformationen liefert.
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von provider
.
Implementiert
Beispiele
Im folgenden Beispiel wird ein Array von Int16 Werten durchlaufen und jeder von ihnen in der Konsole angezeigt, indem die Int16.ToString(IFormatProvider) -Methode mit verschiedenen Formatanbietern aufgerufen wird. Aufgrund der einfachen Formatierung, die durch den Standardformatbezeichner "G" definiert wird, sind die formatierten Zeichenfolgen, die für jeden Int16 Wert erstellt werden, unabhängig vom Wert des provider
Parameters identisch.
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)
Hinweise
Die ToString(IFormatProvider) -Methode formatiert einen Int16 Wert im Standardformat ("G" oder allgemein), indem das NumberFormatInfo Objekt einer angegebenen Kultur verwendet wird. Wenn Sie ein anderes Format oder die aktuelle Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString -Methode wie folgt:
So verwenden Sie das Format | Für Kultur | Verwenden der Überladung |
---|---|---|
Standardformat ("G") | Standardkultur (aktuelle Kultur) | ToString() |
Ein bestimmtes Format | Standardkultur (aktuelle Kultur) | ToString(String) |
Ein bestimmtes Format | Eine bestimmte Kultur | ToString(String, IFormatProvider) |
.NET bietet umfangreiche Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.
Der provider
Parameter ist eine IFormatProvider Implementierung, deren IFormatProvider.GetFormat Methode ein NumberFormatInfo -Objekt zurückgibt. In der provider
Regel ist ein NumberFormatInfo Objekt oder ein CultureInfo Objekt. Das NumberFormatInfo -Objekt stellt kulturspezifische Informationen zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereit. Wenn provider
ist null
, wird diese Instanz mit dem NumberFormatInfo -Objekt für die aktuelle Kultur formatiert.
Weitere Informationen
Gilt für:
ToString(String)
- Quelle:
- Int16.cs
- Quelle:
- Int16.cs
- Quelle:
- Int16.cs
Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.
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
Parameter
- format
- String
Eine numerische Formatierungszeichenfolge.
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format
.
Beispiele
Im folgenden Beispiel werden zwei Int16 Werte initialisiert und mit jeder unterstützten Standardformatzeichenfolge und mehreren benutzerdefinierten Formatzeichenfolgen in der Konsole angezeigt. Das Beispiel wird mit en-US als aktuelle Kultur ausgeführt.
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
Hinweise
Die ToString(String) -Methode formatiert einen Int16 Wert in einem angegebenen Format, indem ein NumberFormatInfo -Objekt verwendet wird, das die Konventionen der aktuellen Kultur darstellt. Wenn Sie das Standardformat ("G" oder allgemein) verwenden oder eine andere Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString Methode wie folgt:
So verwenden Sie das Format | Für Kultur | Verwenden der Überladung |
---|---|---|
Standardformat ("G") | Standardkultur (aktuelle Kultur) | ToString() |
Standardformat ("G") | Eine bestimmte Kultur | ToString(IFormatProvider) |
Ein bestimmtes Format | Eine bestimmte Kultur | ToString(String, IFormatProvider) |
Der format
Parameter kann entweder eine Standard- oder eine benutzerdefinierte numerische Formatzeichenfolge sein. Alle standardmäßigen numerischen Formatzeichenfolgen außer "R" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten numerischen Formatzeichen. Wenn format
es sich um eine leere Zeichenfolge handelt null
, wird der Rückgabewert dieser Instanz mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert.
.NET bietet umfangreiche Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.
Der Rückgabewert dieser Instanz ist mit dem NumberFormatInfo für die aktuelle Kultur formatiert.
Weitere Informationen
- Parse(String)
- String
- Formatieren von Typen in .NET
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen
- How to: Auffüllen einer Zahl mit führenden Nullen
Gilt für:
ToString(String, IFormatProvider)
- Quelle:
- Int16.cs
- Quelle:
- Int16.cs
- Quelle:
- Int16.cs
Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
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
Parameter
- format
- String
Eine numerische Formatierungszeichenfolge.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format
und provider
.
Implementiert
Beispiele
Im folgenden Beispiel wird ein Int16 Wert angezeigt, der jede der unterstützten Standardformatzeichenfolgen in vier verschiedenen Kulturen verwendet.
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
Hinweise
Die ToString(String, IFormatProvider) -Methode formatiert einen Int16 Wert in einem angegebenen Format, indem das NumberFormatInfo Objekt einer angegebenen Kultur verwendet wird. Wenn Sie die Standardformat- oder Kultureinstellungen verwenden möchten, verwenden Sie die anderen Überladungen der ToString -Methode wie folgt:
So verwenden Sie das Format | Für Kultur | Verwenden der Überladung |
---|---|---|
Standardformat ("G") | Standardkultur (aktuelle Kultur) | ToString() |
Standardformat ("G") | Eine bestimmte Kultur | ToString(IFormatProvider) |
Ein bestimmtes Format | Standardkultur (aktuelle Kultur) | ToString(String) |
Der format
Parameter kann entweder eine Standard- oder eine benutzerdefinierte numerische Formatzeichenfolge sein. Alle standardmäßigen numerischen Formatzeichenfolgen außer "R" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten numerischen Formatzeichen. Wenn format
eine leere Zeichenfolge ("") ist null
, wird die von dieser Methode zurückgegebene Zeichenfolge mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert.
.NET bietet umfangreiche Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.
Der provider
Parameter ist eine IFormatProvider Implementierung. Die - GetFormat Methode gibt ein NumberFormatInfo -Objekt zurück, das kulturspezifische Informationen über das Format der Zeichenfolge bereitstellt, die von dieser Methode zurückgegeben wird. Das Objekt, das implementiert IFormatProvider , kann eines der folgenden Sein:
Ein CultureInfo -Objekt, das die Kultur darstellt, deren Formatierungsregeln verwendet werden sollen.
Ein NumberFormatInfo -Objekt, das bestimmte numerische Formatierungsinformationen für diesen Wert enthält.
Ein benutzerdefiniertes IFormatProviderObjekt, das implementiert.
Wenn provider
ist null
oder aus kein NumberFormatInfo -Objekt abgerufen provider
werden kann, wird der Rückgabewert mit dem NumberFormatInfo für die aktuelle Kultur formatiert.
Weitere Informationen
- Parse(String)
- Formatieren von Typen in .NET
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen
- How to: Auffüllen einer Zahl mit führenden Nullen
- Beispiel: .NET Core-Hilfsprogramm zur Formatierung von WinForms (C#)
- Beispiel: .NET Core-Hilfsprogramm zur Formatierung von WinForms (Visual Basic)