Int16.ToString Int16.ToString Int16.ToString Int16.ToString Method

Definition

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) ToString(IFormatProvider) ToString(IFormatProvider) 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) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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) ToString(String) ToString(String) 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() ToString() ToString() ToString()

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

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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 string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parameter

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein IFormatProvider, der kulturabhängige Formatierungsinformationen liefert.An IFormatProvider that supplies culture-specific formatting information.

Gibt zurück

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

Beispiele

Im folgenden Beispiel wird ein Array von Int16 Werte und jedes Mitglied in der Konsole angezeigt, durch den Aufruf der Int16.ToString(IFormatProvider) -Methode mit verschiedenen Formatanbieter.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, indem Sie den Standardformatbezeichner "G" definierten Formatierung erzeugten formatierten Zeichenfolgen für die einzelnen Int16 Wert sind identisch, unabhängig vom Wert für die provider Parameter.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

Der ToString(IFormatProvider) -Methode formatiert einen Int16 Wert in der Standardeinstellung ("G" oder Allgemein) Format unter Verwendung der NumberFormatInfo Objekt der 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 alle anderen Überladungen der 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:

Format verwendenTo use format Für die KulturFor culture Verwenden Sie die ÜberladungUse the overload
Standardformat ("G")Default ("G") format (Aktueller) StandardkulturDefault (current) culture ToString()
Einem bestimmten formatA specific format (Aktueller) StandardkulturDefault (current) culture ToString(String)
Einem bestimmten formatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Die provider -Parameter ist ein IFormatProvider Implementierung, deren IFormatProvider.GetFormat Methode gibt eine NumberFormatInfo Objekt.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. In der Regel provider ist eine NumberFormatInfo Objekt oder ein CultureInfo Objekt.Typically, provider is a NumberFormatInfo object or a CultureInfo object. Die NumberFormatInfo Objekt stellt kulturspezifische Informationen zum Format der von dieser Methode zurückgegebene Zeichenfolge.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 formatiert die NumberFormatInfo Objekt für die aktuelle Kultur.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

Siehe auch

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parameter

format
String String String String

Eine numerische Formatierungszeichenfolge.A numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

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

Gibt zurück

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

Beispiele

Das folgende Beispiel zeigt eine Int16 Wert, indem Sie die unterstützen Standardformatzeichenfolgen in vier verschiedenen Kulturen.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 Formate eine Int16 Wert in einem angegebenen Format mithilfe der NumberFormatInfo Objekt der 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 Standardeinstellungen Format oder die Kultur verwenden möchten, verwenden Sie alle anderen Überladungen der 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:

Format verwendenTo use format Für die KulturFor culture Verwenden Sie die ÜberladungUse the overload
Standardformat ("G")Default ("G") format (Aktueller) StandardkulturDefault (current) culture ToString()
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Einem bestimmten formatA specific format (Aktueller) StandardkulturDefault (current) culture ToString(String)

Die format Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Formatzeichenfolge sein.The format parameter can be either a standard or a custom numeric format string. Alle numerischen Standardformatzeichenfolgen als "R" (oder "R") werden unterstützt, da alle benutzerdefinierten numerischen Formatierungszeichen sind.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Wenn format ist null oder eine leere Zeichenfolge (""), die von dieser Methode zurückgegebene Zeichenfolge mit dem allgemeinen numerische Formatbezeichner ("G") formatiert ist.If format is null or an empty string (""), the string returned by this method is formatted with the general numeric format specifier ("G").

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Die provider -Parameter ist ein IFormatProvider Implementierung.The provider parameter is an IFormatProvider implementation. Die GetFormat Methode gibt eine NumberFormatInfo -Objekt, das kulturspezifische Informationen zum Format der Zeichenfolge enthält, 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 IFormatProvider kann eine der folgenden sein:The object that implements IFormatProvider can be any of the following:

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

  • Ein NumberFormatInfo Objekt, das 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 kann nicht abgerufen werden, von provider, der Rückgabewert formatiert wird, mit der NumberFormatInfo für die aktuelle Kultur.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

ToString(String) ToString(String) ToString(String) 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);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parameter

format
String String String String

Eine numerische Formatierungszeichenfolge.A numeric format string.

Gibt zurück

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 initialisiert zwei Int16 Werte und zeigt sie in der Konsole unter Verwendung der die unterstützen Standardformatzeichenfolgen und mehrere benutzerdefinierte Formatzeichenfolgen.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. Im 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 Formate eine Int16 Wert in einem angegebenen Format mithilfe einer NumberFormatInfo Objekt, 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 die Standardeinstellung ("G" oder allgemeine) verwenden möchten formatieren oder eine andere Kultur angeben, verwenden Sie die anderen Überladungen von 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:

Format verwendenTo use format Für die KulturFor culture Verwenden Sie die ÜberladungUse the overload
Standardformat ("G")Default ("G") format (Aktueller) StandardkulturDefault (current) culture ToString()
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Einem bestimmten formatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Die format Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Formatzeichenfolge sein.The format parameter can be either a standard or a custom numeric format string. Alle numerischen Standardformatzeichenfolgen als "R" (oder "R") werden unterstützt, da alle benutzerdefinierten numerischen Formatierungszeichen sind.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Wenn format ist null oder eine leere Zeichenfolge ist, der Rückgabewert von dieser Instanz mit dem allgemeinen numerische Formatbezeichner ("G") formatiert ist.If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier ("G").

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

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

Siehe auch

ToString() ToString() ToString() 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

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, um ein Array von anzuzeigen Int16 Werte in der Konsole.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 in der Standardeinstellung ("G" oder Allgemein) Format unter Verwendung der NumberFormatInfo Objekt der aktuellen Kultur.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 die Kultur angeben möchten, verwenden Sie alle anderen Überladungen der 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:

Format verwendenTo use format Für die KulturFor culture Verwenden Sie die ÜberladungUse the overload
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Einem bestimmten formatA specific format (Aktueller) StandardkulturDefault (current) culture ToString(String)
Einem bestimmten formatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

.NET Framework bietet umfangreiche formatierungsunterstützung, die in den folgenden Themen zur Formatierung 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: