Int16.ToString 方法

定義

將這個執行個體的數值轉換為它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation.

多載

ToString(IFormatProvider)

使用指定的特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

使用指定的格式和文化特性特定的格式資訊,將這個執行個體的數值轉換成它的對等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String)

使用指定格式,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString()

將這個執行個體的數值轉換為它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

使用指定的特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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

參數

provider
IFormatProvider

IFormatProvider,提供特定文化特性的格式資訊。An IFormatProvider that supplies culture-specific formatting information.

傳回

這個執行個體值的字串表示,如同 provider 所指定。The string representation of the value of this instance as specified by provider.

實作

範例

下列範例會逐一查看 Int16 值的陣列,並藉由呼叫 Int16.ToString(IFormatProvider) 方法與不同的格式提供者,將每個值顯示到主控台。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. 由於預設 "G" 格式規範所定義的簡單格式,不論 provider 參數的值為何,為每個 Int16 值所產生的格式化字串都相同。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)      

備註

ToString(IFormatProvider) 方法會使用指定文化特性的 NumberFormatInfo 物件,以預設("G" 或一般)格式來格式化 Int16 值。The ToString(IFormatProvider) method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. 如果您想要指定不同的格式或目前的文化特性,請使用 ToString 方法的其他多載,如下所示:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

若要使用格式To use format 針對文化特性For culture 使用多載Use the overload
預設值("G")格式Default ("G") format 預設(目前)文化特性Default (current) culture ToString()
特定格式A specific format 預設(目前)文化特性Default (current) culture ToString(String)
特定格式A specific format 特定文化特性A specific culture ToString(String, IFormatProvider)

.NET Framework 提供廣泛的格式設定支援,在下列格式設定主題中有更詳細的說明:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

provider 參數是 IFormatProvider 的實作為,其 IFormatProvider.GetFormat 方法會傳回 NumberFormatInfo 物件。The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. 一般來說,providerNumberFormatInfo 物件或 CultureInfo 物件。Typically, provider is a NumberFormatInfo object or a CultureInfo object. NumberFormatInfo 物件會提供有關此方法所傳回之字串格式的特定文化特性資訊。The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. 如果 null``provider,則會使用目前文化特性的 NumberFormatInfo 物件來格式化這個實例。If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

另請參閱

ToString(String, IFormatProvider)

使用指定的格式和文化特性特定的格式資訊,將這個執行個體的數值轉換成它的對等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

參數

format
String

數值格式字串。A numeric format string.

provider
IFormatProvider

物件,提供特定文化特性格式資訊。An object that supplies culture-specific formatting information.

傳回

這個執行個體值的字串表示,如同 formatprovider 所指定。The string representation of the value of this instance as specified by format and provider.

實作

範例

下列範例會使用四種不同文化特性中每個支援的標準格式字串來顯示 Int16 值。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  

備註

ToString(String, IFormatProvider) 方法會使用指定文化特性的 NumberFormatInfo 物件,以指定的格式來格式化 Int16 的值。The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object of a specified culture. 如果您想要使用預設格式或文化特性設定,請使用 ToString 方法的其他多載,如下所示:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

若要使用格式To use format 針對文化特性For culture 使用多載Use the overload
預設值("G")格式Default ("G") format 預設(目前)文化特性Default (current) culture ToString()
預設值("G")格式Default ("G") format 特定文化特性A specific culture ToString(IFormatProvider)
特定格式A specific format 預設(目前)文化特性Default (current) culture ToString(String)

format 參數可以是標準或自訂數值格式字串。The format parameter can be either a standard or a custom numeric format string. 除了 "R" (或 "r")以外的所有標準數值格式字串都受到支援,如同所有自訂數值格式字元。All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. 如果 formatnull 或空字串(""),則此方法所傳回的字串會使用一般數值格式規範("G")進行格式化。If format is null or an empty string (""), the string returned by this method is formatted with the general numeric format specifier ("G").

.NET Framework 提供廣泛的格式設定支援,在下列格式設定主題中有更詳細的說明:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

provider 參數是 IFormatProvider 的實作為。The provider parameter is an IFormatProvider implementation. 它的 GetFormat 方法會傳回一個 NumberFormatInfo 物件,它會提供有關此方法所傳回之字串格式的特定文化特性資訊。Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. 執行 IFormatProvider 的物件可以是下列任何一項:The object that implements IFormatProvider can be any of the following:

  • CultureInfo 物件,代表要使用其格式化規則的文化特性。A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfo 物件,其中包含此值的特定數值格式資訊。A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • 執行 IFormatProvider的自訂物件。A custom object that implements IFormatProvider.

如果 provider null,或無法從 provider取得 NumberFormatInfo 物件,則會使用目前文化特性的 NumberFormatInfo 來格式化傳回值。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.

另請參閱

ToString(String)

使用指定格式,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation, using the specified format.

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

參數

format
String

數值格式字串。A numeric format string.

傳回

這個執行個體值的字串表示,如同 format 所指定。The string representation of the value of this instance as specified by format.

範例

下列範例會初始化兩個 Int16 值,並使用每個支援的標準格式字串和數個自訂格式字串,將其顯示在主控台中。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. 此範例會以 en-us 作為目前的文化特性來執行。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      

備註

ToString(String) 方法會使用代表目前文化特性慣例的 NumberFormatInfo 物件,以指定的格式來格式化 Int16 值。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. 如果您想要使用預設值("G" 或一般)格式或指定不同的文化特性,請使用 ToString 方法的其他多載,如下所示: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:

若要使用格式To use format 針對文化特性For culture 使用多載Use the overload
預設值("G")格式Default ("G") format 預設(目前)文化特性Default (current) culture ToString()
預設值("G")格式Default ("G") format 特定文化特性A specific culture ToString(IFormatProvider)
特定格式A specific format 特定文化特性A specific culture ToString(String, IFormatProvider)

format 參數可以是標準或自訂數值格式字串。The format parameter can be either a standard or a custom numeric format string. 除了 "R" (或 "r")以外的所有標準數值格式字串都受到支援,如同所有自訂數值格式字元。All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. 如果 formatnull 或空字串,則會使用一般數值格式規範("G")來格式化這個實例的傳回值。If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier ("G").

.NET Framework 提供廣泛的格式設定支援,在下列格式設定主題中有更詳細的說明:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

這個實例的傳回值會使用目前文化特性的 NumberFormatInfo 進行格式化。The return value of this instance is formatted with the NumberFormatInfo for the current culture.

另請參閱

ToString()

將這個執行個體的數值轉換為它的相等字串表示。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

傳回

這個執行個體值的字串表示,包含減號 (如果數值為負) 及一連串範圍由 0 到 9 的數字 (沒有前置字元零)。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.

範例

下列範例會使用 ToString() 方法,將 Int16 值的陣列顯示到主控台。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                             

備註

ToString() 方法會使用目前文化特性的 NumberFormatInfo 物件,以預設("G" 或一般)格式來格式化 Int16 值。The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. 如果您想要指定不同的格式或文化特性,請使用 ToString 方法的其他多載,如下所示:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

若要使用格式To use format 針對文化特性For culture 使用多載Use the overload
預設值("G")格式Default ("G") format 特定文化特性A specific culture ToString(IFormatProvider)
特定格式A specific format 預設(目前)文化特性Default (current) culture ToString(String)
特定格式A specific format 特定文化特性A specific culture ToString(String, IFormatProvider)

.NET Framework 提供廣泛的格式設定支援,在下列格式設定主題中有更詳細的說明:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

另請參閱

適用於