SByte.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 format 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

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

傳回

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

實作

範例

下列範例會定義自訂NumberFormatInfo物件,並將 "~" 字元指派給NegativeSign其屬性。The following example defines a custom NumberFormatInfo object and assigns the "~" character to its NegativeSign property. 然後,此範例會使用此自訂物件NumberFormatInfo以及不因文化特性而異的物件來格式化一系列的SByte值。The example then uses this custom object as well as the NumberFormatInfo object of the invariant culture to format a series of SByte values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define a custom NumberFormatInfo object with "~" as its negative sign.
      NumberFormatInfo nfi = new NumberFormatInfo();
      nfi.NegativeSign = "~";
      
      // Initialize an array of SByte values.
      sbyte[] bytes = { -122, 17, 124 };

      // Display the formatted result using the custom provider.
      Console.WriteLine("Using the custom NumberFormatInfo object:");
      foreach (sbyte value in bytes)
         Console.WriteLine(value.ToString(nfi));

      Console.WriteLine();
          
      // Display the formatted result using the invariant culture.
      Console.WriteLine("Using the invariant culture:");
      foreach (sbyte value in bytes)
         Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo));
   }
}
// The example displays the following output:
//       Using the custom NumberFormatInfo object:
//       ~122
//       17
//       124
//       
//       Using the invariant culture:
//       -122
//       17
//       124
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define a custom NumberFormatInfo object with "~" as its negative sign.
      Dim nfi As New NumberFormatInfo()
      nfi.NegativeSign = "~"
      
      ' Initialize an array of SByte values.
      Dim bytes() As SByte = { -122, 17, 124 }

      ' Display the formatted result using the custom provider.
      Console.WriteLine("Using the custom NumberFormatInfo object:")
      For Each value As SByte In bytes
         Console.WriteLine(value.ToString(nfi))
      Next
      Console.WriteLine()
          
      ' Display the formatted result using the invariant culture.
      Console.WriteLine("Using the invariant culture:")
      For Each value As SByte In bytes
         Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo))
      Next   
   End Sub
End Module
' The example displays the following output:
'       Using the custom NumberFormatInfo object:
'       ~122
'       17
'       124
'       
'       Using the invariant culture:
'       -122
'       17
'       124

備註

方法會使用指定SByte文化特性的預設("G" 或一般)格式來格式化值。 ToString(IFormatProvider)The ToString(IFormatProvider) method formats an SByte value in the default ("G", or general) format 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)

參數是一種IFormatProvider實作為。 providerThe 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 returned by this method. 如果providernull,則會NumberFormatInfo使用目前文化特性的物件來格式化值。SByteIf provider is null, the SByte value is formatted using the NumberFormatInfo object of the current culture. NumberFormatInfo物件的唯一屬性, 會使用一般格式規範來控制SByte值的字串表示, 這會NumberFormatInfo.NegativeSign定義代表負號的字元。The only property of the NumberFormatInfo object that controls the string representation of the SByte value using the general format specifier is NumberFormatInfo.NegativeSign, which defines the character that represents the negative sign.

provider參數可以是下列其中一項:The provider parameter can be one of the following:

另請參閱

ToString(String, IFormatProvider)

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

實作

例外狀況

format 無效。format is invalid.

範例

下列範例會使用標準數值格式規範和一些SByte特定CultureInfo物件來顯示正和負數值。The following example displays both a positive and a negative SByte value using the standard numeric format specifiers and a number of specific CultureInfo objects.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define cultures whose formatting conventions are to be used.
      CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"), 
                                 CultureInfo.CreateSpecificCulture("fr-FR"), 
                                 CultureInfo.CreateSpecificCulture("es-ES") };
      sbyte positiveNumber = 119;
      sbyte negativeNumber = -45;
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 16} {3, 16}",  
                              specifier, culture.Name, 
                              positiveNumber.ToString(specifier, culture), 
                              negativeNumber.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//     G format using en-US culture:              119              -45
//     G format using fr-FR culture:              119              -45
//     G format using es-ES culture:              119              -45
//    
//     C format using en-US culture:          $119.00         ($45.00)
//     C format using fr-FR culture:         119,00 €         -45,00 €
//     C format using es-ES culture:         119,00 €         -45,00 €
//    
//    D4 format using en-US culture:             0119            -0045
//    D4 format using fr-FR culture:             0119            -0045
//    D4 format using es-ES culture:             0119            -0045
//    
//    E2 format using en-US culture:        1.19E+002       -4.50E+001
//    E2 format using fr-FR culture:        1,19E+002       -4,50E+001
//    E2 format using es-ES culture:        1,19E+002       -4,50E+001
//    
//     F format using en-US culture:           119.00           -45.00
//     F format using fr-FR culture:           119,00           -45,00
//     F format using es-ES culture:           119,00           -45,00
//    
//     N format using en-US culture:           119.00           -45.00
//     N format using fr-FR culture:           119,00           -45,00
//     N format using es-ES culture:           119,00           -45,00
//    
//     P format using en-US culture:      11,900.00 %      -4,500.00 %
//     P format using fr-FR culture:      11 900,00 %      -4 500,00 %
//     P format using es-ES culture:      11.900,00 %      -4.500,00 %
//    
//    X2 format using en-US culture:               77               D3
//    X2 format using fr-FR culture:               77               D3
//    X2 format using es-ES culture:               77               D3
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define cultures whose formatting conventions are to be used.
      Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
                                       CultureInfo.CreateSpecificCulture("fr-FR"), _
                                       CultureInfo.CreateSpecificCulture("es-ES") }
      Dim positiveNumber As SByte = 119
      Dim negativeNumber As SByte = -45
      Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"} 
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 16} {3, 16}", _ 
                              specifier, culture.Name, _
                              positiveNumber.ToString(specifier, culture), _
                              negativeNumber.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'     G format using en-US culture:              119              -45
'     G format using fr-FR culture:              119              -45
'     G format using es-ES culture:              119              -45
'    
'     C format using en-US culture:          $119.00         ($45.00)
'     C format using fr-FR culture:         119,00 €         -45,00 €
'     C format using es-ES culture:         119,00 €         -45,00 €
'    
'    D4 format using en-US culture:             0119            -0045
'    D4 format using fr-FR culture:             0119            -0045
'    D4 format using es-ES culture:             0119            -0045
'    
'    E2 format using en-US culture:        1.19E+002       -4.50E+001
'    E2 format using fr-FR culture:        1,19E+002       -4,50E+001
'    E2 format using es-ES culture:        1,19E+002       -4,50E+001
'    
'     F format using en-US culture:           119.00           -45.00
'     F format using fr-FR culture:           119,00           -45,00
'     F format using es-ES culture:           119,00           -45,00
'    
'     N format using en-US culture:           119.00           -45.00
'     N format using fr-FR culture:           119,00           -45,00
'     N format using es-ES culture:           119,00           -45,00
'    
'     P format using en-US culture:      11,900.00 %      -4,500.00 %
'     P format using fr-FR culture:      11 900,00 %      -4 500,00 %
'     P format using es-ES culture:      11.900,00 %      -4.500,00 %
'    
'    X2 format using en-US culture:               77               D3
'    X2 format using fr-FR culture:               77               D3
'    X2 format using es-ES culture:               77               D3

備註

方法會使用指定SByte之文化特性的指定格式來格式化值。 ToString(String, IFormatProvider)The ToString(String, IFormatProvider) method formats an SByte value in a specified format 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 any valid standard numeric format specifier, or any combination of custom numeric format specifiers. 如果format SByte等於或為null,則會使用一般格式規範("G")來格式化目前物件的傳回值。 String.EmptyIf format is equal to String.Empty or is null, the return value of the current SByte object is formatted with the general format specifier ("G"). 如果format是任何其他值, 則方法FormatException會擲回。If format is any other value, the method throws a FormatException.

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

參數是一種IFormatProvider實作為。 providerThe 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 returned by this method. IFormatProvider.GetFormat Type 叫用NumberFormatInfo方法時, 它會呼叫參數的方法,並將代表該類型的物件傳遞給它。provider ToString(String, IFormatProvider)When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's IFormatProvider.GetFormat method and passes it a Type object that represents the NumberFormatInfo type. 然後, 方法會value傳回物件,提供設定參數格式的資訊,例如負號符號、群組分隔符號符號或小數點符號。NumberFormatInfo GetFormatThe GetFormat method then returns the NumberFormatInfo object that provides information for formatting the value parameter, such as the negative sign symbol, the group separator symbol, or the decimal point symbol. 有三種方式可使用provider參數將格式資訊提供ToString(String, IFormatProvider)給方法:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

如果provider NumberFormatInfonull, 則傳回字串的格式會以目前文化特性的物件為基礎。If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of 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 standard or custom numeric format string.

傳回

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

例外狀況

format 無效。format is invalid.

範例

下列範例會初始化值的SByte陣列,並使用每個標準格式字串和一些自訂格式字串來顯示它們。The following example initializes an array of SByte values and displays them by using each standard format string and some custom format strings.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      sbyte[] values = { -124, 0, 118 };
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "00.0", "#.0", 
                              "000;(0);**Zero**" };
      
      foreach (sbyte value in values)
      {
         foreach (string specifier in specifiers)
            Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       G: -124
//       C: ($124.00)
//       D3: -124
//       E2: -1.24E+002
//       e3: -1.240e+002
//       F: -124.00
//       N: -124.00
//       P: -12,400.00 %
//       X: 84
//       00.0: -124.0
//       #.0: -124.0
//       000;(0);**Zero**: (124)
//       
//       G: 0
//       C: $0.00
//       D3: 000
//       E2: 0.00E+000
//       e3: 0.000e+000
//       F: 0.00
//       N: 0.00
//       P: 0.00 %
//       X: 0
//       00.0: 00.0
//       #.0: .0
//       000;(0);**Zero**: **Zero**
//       
//       G: 118
//       C: $118.00
//       D3: 118
//       E2: 1.18E+002
//       e3: 1.180e+002
//       F: 118.00
//       N: 118.00
//       P: 11,800.00 %
//       X: 76
//       00.0: 118.0
//       #.0: 118.0
//       000;(0);**Zero**: 118
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As SByte = { -124, 0, 118 }
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "00.0", "#.0", _
                                     "000;(0);**Zero**" }
      
      For Each value As SByte In values
         For Each specifier As String In specifiers
            Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'       G: -124
'       C: ($124.00)
'       D3: -124
'       E2: -1.24E+002
'       e3: -1.240e+002
'       F: -124.00
'       N: -124.00
'       P: -12,400.00 %
'       X: 84
'       00.0: -124.0
'       #.0: -124.0
'       000;(0);**Zero**: (124)
'       
'       G: 0
'       C: $0.00
'       D3: 000
'       E2: 0.00E+000
'       e3: 0.000e+000
'       F: 0.00
'       N: 0.00
'       P: 0.00 %
'       X: 0
'       00.0: 00.0
'       #.0: .0
'       000;(0);**Zero**: **Zero**
'       
'       G: 118
'       C: $118.00
'       D3: 118
'       E2: 1.18E+002
'       e3: 1.180e+002
'       F: 118.00
'       N: 118.00
'       P: 11,800.00 %
'       X: 76
'       00.0: 118.0
'       #.0: 118.0
'       000;(0);**Zero**: 118

備註

方法會使用目前SByte文化特性的慣例來格式化指定格式的值。 ToString(String)The ToString(String) method formats an SByte value in a specified format by using 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 any valid standard numeric format specifier, or any combination of custom numeric format specifiers. 如果format SByte等於或為null,則會使用一般格式規範("G")來格式化目前物件的傳回值。 String.EmptyIf format is equal to String.Empty or is null, the return value of the current SByte object is formatted with the general format specifier ("G"). 如果format是任何其他值, 則方法FormatException會擲回。If format is any other value, the method throws a FormatException.

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

傳回字串的格式是由目前文化特性的NumberFormatInfo物件所決定。The format of the returned string is determined by the NumberFormatInfo object for the current culture. format視參數而定, 此物件會控制符號, 例如負號、群組分隔符號, 以及輸出字串中的小數點符號。Depending on the format parameter, this object controls symbols such as the negative sign, the group separator, and the decimal point symbol in the output string. 若要提供目前文化特性以外文化特性的格式資訊, 請ToString(String, IFormatProvider)呼叫多載。To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

另請參閱

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 negative sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

範例

下列範例會使用預設SByte ToString()方法來顯示值。The following example displays an SByte value using the default ToString() method. 它也會顯示使用一些標準格式SByte規範所產生之值的字串表示。It also displays the string representations of the SByte value that results from using a number of standard format specifiers. 這些範例會使用 en-us 文化特性的格式化慣例來顯示。The examples are displayed using the formatting conventions of the en-US culture.

using System;

public class Example
{
   public static void Main()
   {
      sbyte value = -123;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());            // Displays -123
      // Display value using some standard format specifiers.
      Console.WriteLine(value.ToString("G"));         // Displays -123
      Console.WriteLine(value.ToString("C"));         // Displays ($-123.00)
      Console.WriteLine(value.ToString("D"));         // Displays -123
      Console.WriteLine(value.ToString("F"));         // Displays -123.00
      Console.WriteLine(value.ToString("N"));         // Displays -123.00
      Console.WriteLine(value.ToString("X"));         // Displays 85
   }
}
Module Example
   Public Sub Main()
      Dim value As SByte = -123
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            ' Displays -123
      ' Display value using some standard format specifiers.
      Console.WriteLine(value.ToString("G"))         ' Displays -123
      Console.WriteLine(value.ToString("C"))         ' Displays ($-123.00)
      Console.WriteLine(value.ToString("D"))         ' Displays -123
      Console.WriteLine(value.ToString("F"))         ' Displays -123.00
      Console.WriteLine(value.ToString("N"))         ' Displays -123.00
      Console.WriteLine(value.ToString("X"))         ' Displays 85
   End Sub
End Module

備註

方法會以目前SByte文化特性的預設("G" 或一般)格式來格式化值。 ToString()The ToString() method formats an SByte value in the default ("G", or general) format 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)

傳回值是使用一般數值格式規範("G")來格式化, SByte值的字串標記法會在其值為負數時包含負號,而從0到9的數位序列則不會有前置零。The return value is formatted using the general numeric format specifier ("G") The string representation of the SByte value includes a negative sign if its value is negative, and a sequence of digits ranging from 0 to 9 without leading zeros. 負號是由目前文化特性NumberFormatInfo的物件所定義。The negative sign is defined by the NumberFormatInfo object for the current culture.

若要定義帶正負號位元組值的字串表示格式,請呼叫ToString(String)方法。To define the formatting of the signed byte value's string representation, call the ToString(String) method.

另請參閱

適用於