Teilen über


Int16.ToString Methode

Definition

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

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:

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:

Der Rückgabewert dieser Instanz ist mit dem NumberFormatInfo für die aktuelle Kultur formatiert.

Weitere Informationen

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:

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 nulloder aus kein NumberFormatInfo -Objekt abgerufen providerwerden kann, wird der Rückgabewert mit dem NumberFormatInfo für die aktuelle Kultur formatiert.

Weitere Informationen

Gilt für: