Sdílet prostřednictvím


Int16.ToString Metoda

Definice

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.

Přetížení

ToString()

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

ToString(String)

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu.

ToString(String, IFormatProvider)

Převede číselnou hodnotu této instance na ekvivalentní řetězcovou reprezentaci pomocí zadaného formátu a informací o formátování specifické pro jazykovou verzi.

ToString()

Zdroj:
Int16.cs
Zdroj:
Int16.cs
Zdroj:
Int16.cs

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření.

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

Návraty

Řetězcová reprezentace hodnoty této instance, která se skládá ze znaménka minus, pokud je hodnota záporná, a posloupnosti číslic v rozsahu od 0 do 9 bez počátečních nul.

Příklady

Následující příklad používá metodu ToString() k zobrazení pole Int16 hodnot v konzole.

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

Poznámky

Metoda ToString() formátuje Int16 hodnotu ve výchozím ("G" nebo obecném) formátu pomocí objektu NumberFormatInfo aktuální jazykové verze. Pokud chcete zadat jiný formát nebo jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:

Použití formátu Pro jazykovou verzi Použití přetížení
Výchozí formát ("G") Konkrétní jazyková verze ToString(IFormatProvider)
Konkrétní formát Výchozí (aktuální) jazyková verze ToString(String)
Konkrétní formát Konkrétní jazyková verze ToString(String, IFormatProvider)

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:

Viz také

Platí pro

ToString(IFormatProvider)

Zdroj:
Int16.cs
Zdroj:
Int16.cs
Zdroj:
Int16.cs

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.

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

Poskytuje IFormatProvider informace o formátování specifické pro jazykovou verzi.

Návraty

Řetězcová reprezentace hodnoty této instance, jak je určena nástrojem provider.

Implementuje

Příklady

Následující příklad iteruje pole Int16 hodnot a zobrazí je do konzoly voláním Int16.ToString(IFormatProvider) metody s různými poskytovateli formátu. 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 parametru provider .

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)

Poznámky

Metoda ToString(IFormatProvider) formátuje Int16 hodnotu ve výchozím formátu ("G" nebo obecné) pomocí objektu NumberFormatInfo zadané jazykové verze. Pokud chcete zadat jiný formát nebo aktuální jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:

Použití formátu Pro jazykovou verzi Použití přetížení
Výchozí formát ("G") Výchozí (aktuální) jazyková verze ToString()
Konkrétní formát Výchozí (aktuální) jazyková verze ToString(String)
Konkrétní formát Konkrétní jazyková verze ToString(String, IFormatProvider)

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:

Parametr provider je IFormatProvider implementace, jejíž IFormatProvider.GetFormat metoda vrací NumberFormatInfo objekt. Obvykle provider se jedná o NumberFormatInfo objekt nebo CultureInfo objekt. Objekt NumberFormatInfo poskytuje informace specifické pro jazykovou verzi o formátu řetězce vráceného touto metodou. Pokud provider je null, je tato instance naformátovaná pomocí objektu NumberFormatInfo pro aktuální jazykovou verzi.

Viz také

Platí pro

ToString(String)

Zdroj:
Int16.cs
Zdroj:
Int16.cs
Zdroj:
Int16.cs

Převádí číselnou hodnotu této instance na její ekvivalentní řetězcové vyjádření pomocí určeného formátu.

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.

Návraty

Řetězcová reprezentace hodnoty této instance, jak je určena nástrojem format.

Příklady

Následující příklad inicializuje dvě Int16 hodnoty a zobrazí je v konzole pomocí každého z podporovaných standardních formátovaných řetězců a několika řetězců vlastního formátu. Příklad je spuštěný s en-US jako aktuální jazykovou verzí.

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

Poznámky

Metoda ToString(String) formátuje Int16 hodnotu v zadaném formátu pomocí objektu NumberFormatInfo , který představuje konvence aktuální jazykové verze. Pokud chcete použít výchozí formát ("G" nebo obecný) nebo zadat jinou jazykovou verzi, použijte další přetížení ToString metody následujícím způsobem:

Použití formátu Pro jazykovou verzi Použití přetížení
Výchozí formát ("G") Výchozí (aktuální) jazyková verze ToString()
Výchozí formát ("G") Konkrétní jazyková verze ToString(IFormatProvider)
Konkrétní formát Konkrétní jazyková verze ToString(String, IFormatProvider)

Parametr format může být standardní nebo vlastní řetězec číselného formátu. 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. Pokud format je null nebo prázdný řetězec, je návratová hodnota této instance naformátovaná pomocí obecného specifikátoru číselného formátu ("G").

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:

Návratová hodnota této instance je naformátovaná s NumberFormatInfo hodnotou pro aktuální jazykovou verzi.

Viz také

Platí pro

ToString(String, IFormatProvider)

Zdroj:
Int16.cs
Zdroj:
Int16.cs
Zdroj:
Int16.cs

Převede číselnou hodnotu této instance na ekvivalentní řetězcovou reprezentaci pomocí zadaného formátu a informací o formátování specifické pro jazykovou verzi.

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.

provider
IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

Řetězcová reprezentace hodnoty této instance podle a formatprovider.

Implementuje

Příklady

Následující příklad zobrazí Int16 hodnotu používající každý z podporovaných řetězců standardního formátu ve čtyřech různých jazykových verzích.

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

Poznámky

Metoda ToString(String, IFormatProvider) formátuje Int16 hodnotu v zadaném formátu pomocí objektu NumberFormatInfo zadané jazykové verze. Pokud chcete použít výchozí nastavení formátu nebo jazykové verze, použijte další přetížení ToString metody následujícím způsobem:

Použití formátu Pro jazykovou verzi Použití přetížení
Výchozí formát ("G") Výchozí (aktuální) jazyková verze ToString()
Výchozí formát ("G") Konkrétní jazyková verze ToString(IFormatProvider)
Konkrétní formát Výchozí (aktuální) jazyková verze ToString(String)

Parametr format může být standardní nebo vlastní řetězec číselného formátu. 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. Pokud format je null nebo prázdný řetězec (""), řetězec vrácený touto metodou je formátován pomocí obecného specifikátoru číselného formátu ("G").

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech formátování:

Parametr provider je IFormatProvider implementace. Jeho GetFormat metoda vrátí NumberFormatInfo objekt, který poskytuje informace specifické pro jazykovou verzi o formátu řetězce, který je vrácen touto metodou. Objekt, který implementuje IFormatProvider , může být kterýkoli z následujících:

  • Objekt CultureInfo , který představuje jazykovou verzi, jejíž pravidla formátování se mají použít.

  • Objekt NumberFormatInfo , který obsahuje specifické informace o číselném formátování pro tuto hodnotu.

  • Vlastní objekt, který implementuje IFormatProvider.

Pokud provider je nullnebo NumberFormatInfo objekt nelze získat z provider, je vrácená hodnota naformátovaná s NumberFormatInfo hodnotou pro aktuální jazykovou verzi.

Viz také

Platí pro