Int16.ToString Metoda

Definice

Obor názvů:: System

Sestavení:: mscorlib.dll, System.Runtime.dll

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Přetížení

Name	Description
ToString(IFormatProvider)	Převede číselnou hodnotu této instance na ekvivalentní řetězcové vyjádření pomocí zadaných informací o formátu specifickém pro jazykovou verzi.
ToString()	Převede číselnou hodnotu této instance na ekvivalentní řetězcové vyjádření.
ToString(String)	Převede číselnou hodnotu této instance na ekvivalentní řetězcové vyjádření pomocí zadaného formátu.
ToString(String, IFormatProvider)	Převede číselnou hodnotu této instance na ekvivalentní řetězcové vyjádření pomocí zadaného formátu a informací o formátování specifickém pro jazykovou verzi.

ToString(IFormatProvider)

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Převede číselnou hodnotu této instance na ekvivalentní řetězcové vyjádření pomocí zadaných informací o formátu specifickém 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

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

Návraty

String

Řetězcové vyjádření hodnoty této instance, jak je určeno provider.

Implementuje

ToString(IFormatProvider)

Příklady

Následující příklad iteruje pole Int16 hodnot a zobrazí každou z nich 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 ve výchozím specifikátoru formátu "G" jsou formátované řetězce vytvořené pro každou Int16 hodnotu stejné 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í NumberFormatInfo objektu 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()
Určitý formát	Výchozí (aktuální) jazyková verze	ToString(String)
Určitý 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 o formátování:

Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce číselného formátu a vlastní řetězce číselného formátu.
Další informace o formátování naleznete v tématu Typy formátování.

Parametr provider je IFormatProvider implementace, jejíž IFormatProvider.GetFormat metoda vrací NumberFormatInfo objekt. provider Obvykle 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, tato instance je formátována s objektem NumberFormatInfo pro aktuální jazykovou verzi.

Viz také

Platí pro

ToString()

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Převede číselnou hodnotu této instance na 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

String

Řetězcová reprezentace hodnoty této instance, která se skládá ze znaménka minus, pokud je hodnota záporná, a posloupnost čí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 formátu ("G" nebo obecné) pomocí NumberFormatInfo objektu 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)
Určitý formát	Výchozí (aktuální) jazyková verze	ToString(String)
Určitý 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 o formátování:

Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce číselného formátu a vlastní řetězce číselného formátu.
Další informace o formátování naleznete v tématu Typy formátování.

Viz také

Platí pro

ToString(String)

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

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

String

Řetězcové vyjádření hodnoty této instance, jak je určeno 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átových řetězců a několika řetězců vlastního formátu. Příklad se spustí 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)
Určitý formát	Konkrétní jazyková verze	ToString(String, IFormatProvider)

Parametr format může být standardní nebo vlastní řetězec číselného formátu. Podporují se všechny standardní řetězce číselného formátu kromě "R" (nebo "r"), stejně jako všechny vlastní znaky číselného formátu. Pokud format je nebo je null prázdný řetězec, návratová hodnota této instance je naformátována specifikátorem obecného čí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 o formátování:

Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce číselného formátu a vlastní řetězce číselného formátu.
Další informace o formátování naleznete v tématu Typy formátování.

Návratová hodnota této instance je naformátována pomocí NumberFormatInfo aktuální jazykové verze.

Viz také

Platí pro

ToString(String, IFormatProvider)

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

Zdroj:: Int16.cs

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

String

Řetězcové vyjádření hodnoty této instance, jak je určeno format a provider.

Implementuje

ToString(String, IFormatProvider)

Příklady

Následující příklad zobrazí Int16 hodnotu pomocí každého z podporovaných standardních formátových řetězců 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í NumberFormatInfo objektu 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)
Určitý 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. Podporují se všechny standardní řetězce číselného formátu 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 o formátování:

Další informace o specifikátorech číselného formátu najdete v tématu standardní řetězce číselného formátu a vlastní řetězce číselného formátu.
Další informace o formátování naleznete v tématu Typy 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 některý 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 konkrétní 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, návratová hodnota je naformátována pro NumberFormatInfo aktuální jazykovou verzi.

Viz také

Parse(String)
Typy formátování v .NET
Standardní řetězce pro formátování čísel
Vlastní řetězce číselného formátu
Postupy: Nastavení čísla s počátečními nulami
Ukázka : rozhraní .NET Core WinForms (C#)
ukázka : .NET Core WinForms Formatting Utility (Visual Basic)

Platí pro

Váš názor

Byla tato stránka užitečná?