Int16.ToString Metoda

Definicja

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

Przeciążenia

ToString(IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu określonego formatu i informacji o formatowaniu specyficznym dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury.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

IFormatProviderDostarcza informacje o formatowaniu specyficzne dla kultury.An IFormatProvider that supplies culture-specific formatting information.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia określony przez provider .The string representation of the value of this instance as specified by provider.

Implementuje

Przykłady

Poniższy przykład iteruje tablicę Int16 wartości i wyświetla każdą z nich w konsoli przez wywołanie Int16.ToString(IFormatProvider) metody z różnymi dostawcami formatu.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. Ze względu na formatowanie proste zdefiniowane przez domyślny specyfikator formatu "G", sformatowane ciągi tworzone dla każdej Int16 wartości są identyczne niezależnie od wartości 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)      

Uwagi

ToString(IFormatProvider)Metoda formatuje Int16 wartość w formacie domyślnym ("G" lub ogólnym) przy użyciu NumberFormatInfo obiektu określonej kultury.The ToString(IFormatProvider) method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Jeśli chcesz określić inny format lub bieżącą kulturę, użyj innych przeciążeń ToString metody w następujący sposób:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

providerParametr jest IFormatProvider implementacją, której IFormatProvider.GetFormat Metoda zwraca NumberFormatInfo obiekt.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Zazwyczaj provider jest NumberFormatInfo obiektem lub CultureInfo obiektem.Typically, provider is a NumberFormatInfo object or a CultureInfo object. NumberFormatInfoObiekt zawiera informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. Jeśli provider jest null , to wystąpienie jest sformatowane przy użyciu NumberFormatInfo obiektu dla bieżącej kultury.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

Zobacz też

Dotyczy

ToString(String, IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu określonego formatu i informacji o formatowaniu specyficznym dla kultury.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

Ciąg formatu liczbowego.A numeric format string.

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.An object that supplies culture-specific formatting information.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia określony przez format i provider .The string representation of the value of this instance as specified by format and provider.

Implementuje

Przykłady

Poniższy przykład wyświetla Int16 wartość przy użyciu każdego obsługiwanego ciągu formatu standardowego w czterech różnych kulturach.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  

Uwagi

ToString(String, IFormatProvider)Metoda formatuje Int16 wartość w określonym formacie przy użyciu NumberFormatInfo obiektu określonej kultury.The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object of a specified culture. Jeśli chcesz użyć domyślnego formatu lub ustawień kultury, użyj innych przeciążeń ToString metody w następujący sposób:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)

formatParametr może być standardowym lub niestandardowym ciągiem formatu liczbowego.The format parameter can be either a standard or a custom numeric format string. Obsługiwane są wszystkie standardowe ciągi formatu liczbowego inne niż „R” (lub „r”), podobnie jak wszystkie znaki niestandardowych formatów liczbowych.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Jeśli format jest null lub jest pustym ciągiem (""), ciąg zwracany przez tę metodę jest formatowany przy użyciu ogólnego specyfikatora formatu liczbowego ("G").If format is null or an empty string (""), the string returned by this method is formatted with the general numeric format specifier ("G").

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

providerParametr jest IFormatProvider implementacją.The provider parameter is an IFormatProvider implementation. Jego GetFormat Metoda zwraca NumberFormatInfo obiekt, który dostarcza informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Obiekt, który implementuje IFormatProvider może być dowolną z następujących:The object that implements IFormatProvider can be any of the following:

  • CultureInfoObiekt reprezentujący kulturę, której reguły formatowania mają być używane.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfoObiekt, który zawiera określone informacje o formatowaniu liczb dla tej wartości.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Obiekt niestandardowy, który implementuje IFormatProvider .A custom object that implements IFormatProvider.

Jeśli provider jest null lub NumberFormatInfo obiekt nie może zostać uzyskany z provider , wartość zwracana jest formatowana przy użyciu NumberFormatInfo dla bieżącej kultury.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.

Zobacz też

Dotyczy

ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu.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

Ciąg formatu liczbowego.A numeric format string.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia określony przez format .The string representation of the value of this instance as specified by format.

Przykłady

W poniższym przykładzie są inicjowane dwie Int16 wartości i są wyświetlane w konsoli programu przy użyciu każdego z obsługiwanych ciągów formatu standardowego i kilku niestandardowych ciągów formatujących.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. Przykład jest uruchamiany z EN-US jako bieżącą kulturą.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      

Uwagi

ToString(String)Metoda formatuje Int16 wartość w określonym formacie przy użyciu NumberFormatInfo obiektu, który reprezentuje konwencje bieżącej kultury.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. Jeśli chcesz użyć domyślnego formatu ("G" lub ogólnego) lub określić inną kulturę, użyj innych przeciążeń ToString metody w następujący sposób: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:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

formatParametr może być standardowym lub niestandardowym ciągiem formatu liczbowego.The format parameter can be either a standard or a custom numeric format string. Obsługiwane są wszystkie standardowe ciągi formatu liczbowego inne niż „R” (lub „r”), podobnie jak wszystkie znaki niestandardowych formatów liczbowych.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Jeśli format jest null lub jest pustym ciągiem, wartość zwracana tego wystąpienia jest formatowana przy użyciu ogólnego specyfikatora formatu liczbowego ("G").If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier ("G").

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Wartość zwracana dla tego wystąpienia jest formatowana przy użyciu NumberFormatInfo dla bieżącej kultury.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Zobacz też

Dotyczy

ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.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

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia, składający się z znaku minus, jeśli wartość jest ujemna, i sekwencją cyfr od 0 do 9 bez zer wiodących.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.

Przykłady

W poniższym przykładzie zastosowano ToString() metodę, aby wyświetlić tablicę Int16 wartości w konsoli.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                             

Uwagi

ToString()Metoda formatuje Int16 wartość w formacie domyślnym ("G" lub ogólnym) przy użyciu NumberFormatInfo obiektu bieżącej kultury.The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Jeśli chcesz określić inny format lub kulturę, użyj innych przeciążeń ToString metody w następujący sposób:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

Środowisko .NET Framework zapewnia rozbudowaną obsługę formatowania. Opisano to szczegółowo w następujących tematach poświęconych formatowaniu:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Zobacz też

Dotyczy