Int16.ToString Metoda

Definice

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.Converts the numeric value of this instance to its equivalent string representation.

Přetížení

ToString(IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určených informací o formátování specifických pro jazykovou verzi.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Převede číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí zadaného formátu a informací o formátování specifických pro jazykovou verzi.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString()

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určených informací o formátování specifických pro jazykovou verzi.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

Parametry

provider
IFormatProvider

IFormatProvider, Který poskytuje informace o formátování specifické pro jazykovou verzi.An IFormatProvider that supplies culture-specific formatting information.

Návraty

String

Řetězcové vyjádření hodnoty této instance, jak Určuje provider .The string representation of the value of this instance as specified by provider.

Implementuje

Příklady

Následující příklad provede iteraci pole Int16 hodnot a zobrazí každý z nich do konzoly voláním Int16.ToString(IFormatProvider) metody s různými poskytovateli formátu.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. Vzhledem k jednoduchému formátování definovanému výchozím specifikátorem formátu "G" jsou formátované řetězce vytvořené pro každou Int16 hodnotu identické bez ohledu na hodnotu provider parametru.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)      

Poznámky

ToString(IFormatProvider)Metoda formátuje Int16 hodnotu ve výchozím formátu ("G" nebo "Obecné") pomocí NumberFormatInfo objektu zadané jazykové verze.The ToString(IFormatProvider) method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Pokud chcete zadat jiný formát nebo aktuální jazykovou verzi, použijte další přetížení ToString metody, jak je znázorněno níže:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

providerParametr je implementace, IFormatProvider jejíž IFormatProvider.GetFormat metoda vrací NumberFormatInfo objekt.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Obvykle provider je NumberFormatInfo objekt nebo CultureInfo objekt.Typically, provider is a NumberFormatInfo object or a CultureInfo object. NumberFormatInfoObjekt poskytuje informace specifické jazykové verze o formátu řetězce vráceného touto metodou.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. Pokud provider je null , tato instance je formátována s NumberFormatInfo objektem pro aktuální jazykovou verzi.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

Viz také

Platí pro

ToString(String, IFormatProvider)

Převede číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí zadaného formátu a informací o formátování specifických pro jazykovou verzi.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

Parametry

format
String

Řetězec číselného formátu.A numeric format string.

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.An object that supplies culture-specific formatting information.

Návraty

String

Řetězcové vyjádření hodnoty této instance, jak je uvedeno v poli format a provider .The string representation of the value of this instance as specified by format and provider.

Implementuje

Příklady

Následující příklad zobrazuje Int16 hodnotu pomocí každého podporovaného standardního formátovacího řetězce ve čtyřech různých jazykových verzích.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  

Poznámky

ToString(String, IFormatProvider)Metoda formátuje Int16 hodnotu v zadaném formátu pomocí NumberFormatInfo objektu zadané jazykové verze.The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object of a specified culture. Pokud chcete použít výchozí formát nebo nastavení jazykové verze, použijte další přetížení ToString metody, jak je znázorněno níže:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)

formatParametr může být buď standardní, nebo vlastní řetězec číselného formátu.The format parameter can be either a standard or a custom numeric format string. Jsou podporovány všechny standardní řetězce formátování čísel kromě "R" (nebo "r"), stejně jako všechny vlastní znaky číselného formátu.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Pokud format je null nebo prázdný řetězec (""), řetězec vrácený touto metodou je formátován pomocí specifikátoru obecného číselného formátu ("G").If format is null or an empty string (""), the string returned by this method is formatted with the general numeric format specifier ("G").

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

providerParametr je IFormatProvider implementace.The provider parameter is an IFormatProvider implementation. Jeho GetFormat Metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické jazykové verze o formátu řetězce, který je vrácený touto metodou.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Objekt, který implementuje, IFormatProvider může být kterýkoli z následujících:The object that implements IFormatProvider can be any of the following:

  • CultureInfoObjekt, který představuje jazykovou verzi, jejíž pravidla formátování se mají použít.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfoObjekt, který obsahuje konkrétní informace o formátování čísel pro tuto hodnotu.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Vlastní objekt, který implementuje IFormatProvider .A custom object that implements IFormatProvider.

Pokud provider je null , nebo NumberFormatInfo nelze získat objekt z provider , návratová hodnota je formátována s hodnotou NumberFormatInfo pro aktuální jazykovou verzi.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.

Viz také

Platí pro

ToString(String)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu.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

Parametry

format
String

Řetězec číselného formátu.A numeric format string.

Návraty

String

Řetězcové vyjádření hodnoty této instance, jak Určuje format .The string representation of the value of this instance as specified by format.

Příklady

Následující příklad inicializuje dvě Int16 hodnoty a zobrazí je v konzole s použitím každého podporovaného standardního formátovacího řetězce a několika vlastních formátovacích řetězců.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. Příklad se spustí s en-US jako aktuální jazyková verze.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      

Poznámky

ToString(String)Metoda formátuje Int16 hodnotu v zadaném formátu pomocí NumberFormatInfo objektu, který představuje konvence aktuální jazykové verze.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. Pokud chcete použít výchozí formát ("G", nebo obecný) nebo zadat jinou jazykovou verzi, použijte další přetížení ToString metody, jak je znázorněno níže: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:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString()
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

formatParametr může být buď standardní, nebo vlastní řetězec číselného formátu.The format parameter can be either a standard or a custom numeric format string. Jsou podporovány všechny standardní řetězce formátování čísel kromě "R" (nebo "r"), stejně jako všechny vlastní znaky číselného formátu.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Pokud format je null nebo prázdný řetězec, návratová hodnota této instance je formátována pomocí obecného specifikátoru číselného formátu ("G").If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier ("G").

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Návratová hodnota této instance je formátována s hodnotou NumberFormatInfo pro aktuální jazykovou verzi.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Viz také

Platí pro

ToString()

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.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

Návraty

String

Řetězcová reprezentace hodnoty této instance, která se skládá z znaménka mínus, pokud je hodnota záporná, a posloupnost číslic od 0 do 9 bez počátečních nul.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.

Příklady

Následující příklad používá ToString() metodu k zobrazení pole Int16 hodnot v konzole.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                             

Poznámky

ToString()Metoda formátuje Int16 hodnotu ve výchozím formátu ("G" nebo "Obecné") pomocí NumberFormatInfo objektu aktuální jazykové verze.The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Pokud chcete zadat jiný formát nebo jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Použití formátuTo use format Pro jazykovou verziFor culture Použití přetíženíUse the overload
Výchozí formát ("G")Default ("G") format Konkrétní jazyková verzeA specific culture ToString(IFormatProvider)
Konkrétní formátA specific format Výchozí (aktuální) Jazyková verzeDefault (current) culture ToString(String)
Konkrétní formátA specific format Konkrétní jazyková verzeA specific culture ToString(String, IFormatProvider)

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Viz také

Platí pro