Int16.ToString Methode

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation.

Überlädt

ToString(IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.
ToString(String, IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.
ToString(String)

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.Converts the numeric value of this instance to its equivalent string representation, using the specified format.
ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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.An IFormatProvider that supplies culture-specific formatting information.

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von provider.The string representation of the value of this instance as specified by provider.

Implementiert

ToString(IFormatProvider)

Beispiele

Im folgenden Beispiel wird ein Array von Int16 -Werten durchlaufen und jede der Konsolen angezeigt, indem die- Int16.ToString(IFormatProvider) Methode mit unterschiedlichen Format Anbietern aufgerufen wird.The following example iterates an array of Int16 values and displays each of them to the console by calling the Int16.ToString(IFormatProvider) method with different format providers. Aufgrund der einfachen Formatierung, die durch den Standardformat Bezeichner "G" definiert ist, sind die für die einzelnen Werte erstellten formatierten Zeichen folgen Int16 unabhängig vom Wert des- provider Parameters identisch.Because of the simple formatting defined by the default "G" format specifier, the formatted strings produced for each Int16 value are identical regardless of the value of the provider parameter.

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)

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) mithilfe des- NumberFormatInfo Objekts einer angegebenen Kultur.The ToString(IFormatProvider) method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Wenn Sie ein anderes Format oder die aktuelle Kultur angeben möchten, verwenden Sie die anderen über Ladungen der- ToString Methode wie folgt:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Standardformat ("G")Default ("G") format Standard Kultur (aktuell)Default (current) culture ToString()
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der- provider Parameter ist eine IFormatProvider Implementierung, deren- IFormatProvider.GetFormat Methode ein-Objekt zurückgibt NumberFormatInfo .The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. In der Regel provider ist ein- NumberFormatInfo Objekt oder ein- CultureInfo Objekt.Typically, provider is a NumberFormatInfo object or a CultureInfo object. Das- NumberFormatInfo Objekt stellt kulturspezifische Informationen zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereit.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. Wenn provider ist null , wird diese Instanz mit dem- NumberFormatInfo Objekt für die aktuelle Kultur formatiert.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

Siehe auch

Gilt für:

ToString(String, IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

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.A numeric format string.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format und provider.The string representation of the value of this instance as specified by format and provider.

Implementiert

ToString(String, IFormatProvider)

Beispiele

Im folgenden Beispiel wird ein- Int16 Wert mit den einzelnen unterstützten Standardformat Zeichenfolgen in vier verschiedenen Kulturen angezeigt.The following example displays an Int16 value using each of the supported standard format strings in four different cultures.

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

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 unter Verwendung des- NumberFormatInfo Objekts einer angegebenen Kultur.The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object of a specified culture. Wenn Sie die Standardformat-oder Kultur Einstellungen verwenden möchten, verwenden Sie die anderen über Ladungen der- ToString Methode wie folgt:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Standardformat ("G")Default ("G") format Standard Kultur (aktuell)Default (current) culture ToString()
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)

Der- format Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Format Zeichenfolge sein.The format parameter can be either a standard or a custom numeric format string. Alle standardmäßigen Zahlenformat Zeichenfolgen außer "r" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten Zahlen Formatierungszeichen.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Wenn format null oder eine leere Zeichenfolge ("") ist, wird die von dieser Methode zurückgegebene Zeichenfolge mit dem allgemeinen numerischen Format Bezeichner ("G") formatiert.If format is null or an empty string (""), the string returned by this method is formatted with the general numeric format specifier ("G").

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der- provider Parameter ist eine- IFormatProvider Implementierung.The provider parameter is an IFormatProvider implementation. Die zugehörige- GetFormat Methode gibt ein- NumberFormatInfo Objekt zurück, das kulturspezifische Informationen über das Format der Zeichenfolge bereitstellt, die von dieser Methode zurückgegeben wird.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Das Objekt, das implementiert, kann eines der IFormatProvider folgenden sein:The object that implements IFormatProvider can be any of the following:

  • Ein- CultureInfo Objekt, das die Kultur darstellt, deren Formatierungs Regeln verwendet werden sollen.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Ein- NumberFormatInfo Objekt, das spezifische numerische Formatierungsinformationen für diesen Wert enthält.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Ein benutzerdefiniertes Objekt, das implementiert IFormatProvider .A custom object that implements IFormatProvider.

Wenn provider ist null , oder ein- NumberFormatInfo Objekt nicht aus abgerufen werden kann provider , wird der Rückgabewert mit der NumberFormatInfo für die aktuelle Kultur formatiert.If provider is null, or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted with the NumberFormatInfo for the current culture.

Siehe auch

Gilt für:

ToString(String)

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

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.A numeric format string.

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format.The string representation of the value of this instance as specified by format.

Beispiele

Im folgenden Beispiel werden zwei Werte initialisiert Int16 und in der Konsole angezeigt, wobei jede der unterstützten Standardformat Zeichenfolgen und mehrere benutzerdefinierte Format Zeichenfolgen verwendet werden.The following example initializes two Int16 values and displays them to the console using each of the supported standard format strings and several custom format strings. Das Beispiel wird mit en-US als aktuelle Kultur ausgeführt.The example is run with en-US as the current culture.

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

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 mithilfe eines- NumberFormatInfo Objekts, das die Konventionen der aktuellen Kultur darstellt.The ToString(String) method formats an Int16 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Wenn Sie das Standardformat ("G" oder "Allgemein") verwenden oder eine andere Kultur angeben möchten, verwenden Sie die anderen über Ladungen der- ToString Methode wie folgt:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Standardformat ("G")Default ("G") format Standard Kultur (aktuell)Default (current) culture ToString()
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Der- format Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Format Zeichenfolge sein.The format parameter can be either a standard or a custom numeric format string. Alle standardmäßigen Zahlenformat Zeichenfolgen außer "r" (oder "r") werden unterstützt, ebenso wie alle benutzerdefinierten Zahlen Formatierungszeichen.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Wenn format null oder eine leere Zeichenfolge ist, wird der Rückgabewert dieser Instanz mit dem allgemeinen numerischen Format Bezeichner ("G") formatiert.If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier ("G").

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der Rückgabewert dieser Instanz wird mit der NumberFormatInfo für die aktuelle Kultur formatiert.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Siehe auch

Gilt für:

ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

String

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.The string representation of the value of this instance, consisting of a minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Beispiele

Im folgenden Beispiel wird die- ToString() Methode verwendet, um ein Array von Int16 Werten in der Konsole anzuzeigen.The following example uses the ToString() method to display an array of Int16 values to the console.

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

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.The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Wenn Sie ein anderes Format oder eine andere Kultur angeben möchten, verwenden Sie die anderen über Ladungen der- ToString Methode wie folgt:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Siehe auch

Gilt für: