UInt16.ToString 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將這個執行個體的數值轉換為其相等字串表示。

多載

ToString(IFormatProvider)	使用指定的特定文化特性格式資訊，將這個執行個體的數值轉換成它的相等字串表示。
ToString(String)	使用指定的格式，將這個執行個體的數值轉換成它的相等字串表示。
ToString(String, IFormatProvider)	使用指定的格式和特定文化特性格式資訊，將這個執行個體的數值轉換成它的相等字串表示。
ToString()	將這個執行個體的數值轉換為其相等字串表示。

ToString(IFormatProvider)

Source:: UInt16.cs

Source:: UInt16.cs

Source:: UInt16.cs

使用指定的特定文化特性格式資訊，將這個執行個體的數值轉換成它的相等字串表示。

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

參數

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

傳回

String

這個執行個體值的字串表示，由 0 到 9 的數字順序所組成，沒有正負號或為零的前置字元。

實作

ToString(IFormatProvider)

範例

下列範例會使用數個格式提供者來格式化 16 位帶正負號的整數值，包括一個用於不變異文化特性。範例的輸出說明方法傳 ToString(IFormatProvider) 回的格式化字串與格式提供者相同。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define an array of CultureInfo objects.
      CultureInfo[] ci = { new CultureInfo("en-US"), 
                           new CultureInfo("fr-FR"), 
                           CultureInfo.InvariantCulture }; 
      UInt16 value = 18924;
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        GetName(ci[0]), GetName(ci[1]), GetName(ci[2])); 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));   
   }

   private static string GetName(CultureInfo ci)
   {
      if (ci.Equals(CultureInfo.InvariantCulture))
         return "Invariant";
      else
         return ci.Name;         
   }
}
// The example displays the following output:
//          en-US          fr-FR      Invariant
//          18924          18924          18924

open System.Globalization

let getName (ci: CultureInfo) =
    if ci.Equals CultureInfo.InvariantCulture then "Invariant"
    else ci.Name

// Define an array of CultureInfo objects.
let ci = 
    [| CultureInfo "en-US" 
       CultureInfo "fr-FR" 
       CultureInfo.InvariantCulture |] 

let value = 18924us
printfn $"  {getName ci[0],12}   {getName ci[1],12}   {getName ci[2],12}"
printfn $"  {value.ToString ci[0],12}   {value.ToString ci[1],12}   {value.ToString ci[2],12}"
// The example displays the following output:
//          en-US          fr-FR      Invariant
//          18924          18924          18924

Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define an array of CultureInfo objects.
      Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
                                  New CultureInfo("fr-FR"), _
                                  CultureInfo.InvariantCulture } 
      Dim value As UInt16 = 18924
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        GetName(ci(0)), GetName(ci(1)), GetName(ci(2))) 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        value.ToString(ci(0)), value.ToString(ci(1)), value.ToString(ci(2)))            
      
   End Sub
   
   Private Function GetName(ci As CultureInfo) As String
      If ci.Equals(CultureInfo.InvariantCulture) Then
         Return "Invariant"
      Else
         Return ci.Name
      End If   
   End Function
End Module
' The example displays the following output:
'         en-US          fr-FR      Invariant
'         18924          18924          18924

備註

方法會 ToString(IFormatProvider)UInt16 使用 NumberFormatInfo 指定文化特性的物件，將預設 (「G」中的值格式化，或一般) 格式。如果您想要指定不同的格式或目前的文化特性，請使用方法的其他多載 ToString ，如下所示：

若要使用格式	針對文化特性	使用多載
預設 (「G」) 格式	預設 (目前) 文化特性	ToString()
特定格式	預設 (目前) 文化特性	ToString(String)
特定格式	特定文化特性	ToString(String, IFormatProvider)

參數 provider 是實作 IFormatProvider 。其 GetFormat 方法會傳 NumberFormatInfo 回提供特定文化特性格式資訊的物件。不過，當使用一般數值格式標準格式化時，不會使用的屬性 NumberFormatInfo (「G」) 。

另請參閱

適用於

ToString(String)

Source:: UInt16.cs

Source:: UInt16.cs

Source:: UInt16.cs

使用指定的格式，將這個執行個體的數值轉換成它的相等字串表示。

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

參數

format: String

數值格式字串。

傳回

String

這個執行個體值的字串表示，如同 format 所指定。

例外狀況

FormatException

format 參數無效。

範例

下列範例會使用每個標準格式字串和一些自訂格式字串，顯示 16 位不帶正負號的整數值。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      ushort value = 21708;
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "000000.0", "#.0", 
                              "00000000;(0);**Zero**" };
      
      foreach (string specifier in specifiers)
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
   }
}
// The example displays the following output:
//       G: 21708
//       C: $21,708.00
//       D3: 21708
//       E2: 2.17E+004
//       e3: 2.171e+004
//       F: 21708.00
//       N: 21,708.00
//       P: 2,170,800.00 %
//       X: 54CC
//       000000.0: 021708.0
//       #.0: 21708.0
//       00000000;(0);**Zero**: 00021708

let value = 21708us
let specifiers = 
    [| "G"; "C"; "D3"; "E2"; "e3"; "F"
       "N"; "P"; "X"; "000000.0"; "#.0" 
       "00000000(0)**Zero**" |]

for specifier in specifiers do
    printfn $"{specifier}: {value.ToString specifier}"
// The example displays the following output:
//       G: 21708
//       C: $21,708.00
//       D3: 21708
//       E2: 2.17E+004
//       e3: 2.171e+004
//       F: 21708.00
//       N: 21,708.00
//       P: 2,170,800.00 %
//       X: 54CC
//       000000.0: 021708.0
//       #.0: 21708.0
//       00000000(0)**Zero**: 00021708

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UShort = 21708 
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "000000.0", "#.0", _
                                     "00000000;(0);**Zero**" }
      
      For Each specifier As String In specifiers
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
      Next
   End Sub
End Module
' The example displays the following output:
'       G: 21708
'       C: $21,708.00
'       D3: 21708
'       E2: 2.17E+004
'       e3: 2.171e+004
'       F: 21708.00
'       N: 21,708.00
'       P: 2,170,800.00 %
'       X: 54CC
'       000000.0: 021708.0
'       #.0: 21708.0
'       00000000;(0);**Zero**: 00021708

備註

方法會 ToString(String) 使用 NumberFormatInfo 代表目前文化特性慣例的物件，以指定格式格式化 UInt16 值。如果您想要使用預設 (「G」，或一般) 格式或指定不同的文化特性，請使用方法的其他多載 ToString ，如下所示：

若要使用格式	針對文化特性	使用多載
預設 (「G」) 格式	預設 (目前) 文化特性	ToString()
預設 (「G」) 格式	特定文化特性	ToString(IFormatProvider)
特定格式	特定文化特性	ToString(String, IFormatProvider)

參數 format 可以是任何有效的標準數值格式規範，或自訂數值格式規範的任何組合。如果 format 等於 String.Empty 或為 null ，則目前 UInt16 物件的傳回值會以一般格式標準格式化， (「G」) 。如果 format 為任何其他值，方法會擲回 FormatException 。

.NET 提供廣泛的格式設定支援，在下列格式設定主題中會更詳細地說明：

如需數值格式規範的詳細資訊，請參閱標準數值格式字串和自訂數值格式字串。
如需 .NET 中格式化支援的詳細資訊，請參閱格式化類型。

傳回字串的格式是由目前文化特性的物件所 NumberFormatInfo 決定。 format根據參數，這個物件會控制群組分隔符號和輸出字串中的小數點符號等符號。若要提供目前文化特性以外的文化特性格式資訊，請呼叫 ToString(String, IFormatProvider) 多載。

另請參閱

適用於

ToString(String, IFormatProvider)

Source:: UInt16.cs

Source:: UInt16.cs

Source:: UInt16.cs

使用指定的格式和特定文化特性格式資訊，將這個執行個體的數值轉換成它的相等字串表示。

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

參數

format: String

數值格式字串。

provider: IFormatProvider

物件，提供特定文化特性格式資訊。

傳回

String

這個執行個體值的字串表示，如同 format 和 provider 所指定。

實作

ToString(String, IFormatProvider)

例外狀況

FormatException

format 無效。

範例

下列範例使用標準數值格式規範和一些特定 CultureInfo 物件，顯示 16 位不帶正負號的整數值。

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") };
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      ushort value = 22042;
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 16}",  
                              specifier, culture.Name, 
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:            22042
//        G format using fr-FR culture:            22042
//        G format using es-ES culture:            22042
//       
//        C format using en-US culture:       $22,042.00
//        C format using fr-FR culture:      22 042,00 €
//        C format using es-ES culture:      22.042,00 €
//       
//       D4 format using en-US culture:            22042
//       D4 format using fr-FR culture:            22042
//       D4 format using es-ES culture:            22042
//       
//       E2 format using en-US culture:        2.20E+004
//       E2 format using fr-FR culture:        2,20E+004
//       E2 format using es-ES culture:        2,20E+004
//       
//        F format using en-US culture:         22042.00
//        F format using fr-FR culture:         22042,00
//        F format using es-ES culture:         22042,00
//       
//        N format using en-US culture:        22,042.00
//        N format using fr-FR culture:        22 042,00
//        N format using es-ES culture:        22.042,00
//       
//        P format using en-US culture:   2,204,200.00 %
//        P format using fr-FR culture:   2 204 200,00 %
//        P format using es-ES culture:   2.204.200,00 %
//       
//       X2 format using en-US culture:             561A
//       X2 format using fr-FR culture:             561A
//       X2 format using es-ES culture:             561A

open System.Globalization

// Define cultures whose formatting conventions are to be used.
let cultures = 
    [| CultureInfo.CreateSpecificCulture "en-US" 
       CultureInfo.CreateSpecificCulture "fr-FR"
       CultureInfo.CreateSpecificCulture "es-ES" |]
let specifiers = [| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |] 
let value = 22042us

for specifier in specifiers do
    for culture in cultures do
        printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 16}"
    printfn ""
// The example displays the following output:
//        G format using en-US culture:            22042
//        G format using fr-FR culture:            22042
//        G format using es-ES culture:            22042
//       
//        C format using en-US culture:       $22,042.00
//        C format using fr-FR culture:      22 042,00 €
//        C format using es-ES culture:      22.042,00 €
//       
//       D4 format using en-US culture:            22042
//       D4 format using fr-FR culture:            22042
//       D4 format using es-ES culture:            22042
//       
//       E2 format using en-US culture:        2.20E+004
//       E2 format using fr-FR culture:        2,20E+004
//       E2 format using es-ES culture:        2,20E+004
//       
//        F format using en-US culture:         22042.00
//        F format using fr-FR culture:         22042,00
//        F format using es-ES culture:         22042,00
//       
//        N format using en-US culture:        22,042.00
//        N format using fr-FR culture:        22 042,00
//        N format using es-ES culture:        22.042,00
//       
//        P format using en-US culture:   2,204,200.00 %
//        P format using fr-FR culture:   2 204 200,00 %
//        P format using es-ES culture:   2.204.200,00 %
//       
//       X2 format using en-US culture:             561A
//       X2 format using fr-FR culture:             561A
//       X2 format using es-ES culture:             561A

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 specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"} 
      Dim value As UShort = 22042
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 16}", _ 
                              specifier, culture.Name, _
                              value.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'        G format using en-US culture:            22042
'        G format using fr-FR culture:            22042
'        G format using es-ES culture:            22042
'       
'        C format using en-US culture:       $22,042.00
'        C format using fr-FR culture:      22 042,00 €
'        C format using es-ES culture:      22.042,00 €
'       
'       D4 format using en-US culture:            22042
'       D4 format using fr-FR culture:            22042
'       D4 format using es-ES culture:            22042
'       
'       E2 format using en-US culture:        2.20E+004
'       E2 format using fr-FR culture:        2,20E+004
'       E2 format using es-ES culture:        2,20E+004
'       
'        F format using en-US culture:         22042.00
'        F format using fr-FR culture:         22042,00
'        F format using es-ES culture:         22042,00
'       
'        N format using en-US culture:        22,042.00
'        N format using fr-FR culture:        22 042,00
'        N format using es-ES culture:        22.042,00
'       
'        P format using en-US culture:   2,204,200.00 %
'        P format using fr-FR culture:   2 204 200,00 %
'        P format using es-ES culture:   2.204.200,00 %
'       
'       X2 format using en-US culture:             561A
'       X2 format using fr-FR culture:             561A
'       X2 format using es-ES culture:             561A

備註

方法會 ToString(String, IFormatProvider) 使用 NumberFormatInfo 指定文化特性的物件，以指定的格式格式化 UInt16 值。如果您想要使用預設格式或文化特性設定，請使用方法的其他多載 ToString ，如下所示：

若要使用格式	針對文化特性	使用多載
預設 (「G」) 格式	預設 (目前) 文化特性	ToString()
預設 (「G」) 格式	特定文化特性	ToString(IFormatProvider)
特定格式	預設 (目前) 文化特性	ToString(String)

參數 format 可以是任何有效的標準數值格式字串，或自訂數值格式字串的任何組合。如果 format 等於 String.Empty 或為 null ，則目前 UInt16 物件的傳回值會以一般格式標準格式化， (「G」) 。如果 format 為任何其他值，方法會擲回 FormatException 。

.NET 提供廣泛的格式設定支援，在下列格式設定主題中會更詳細地說明：

如需數值格式規範的詳細資訊，請參閱標準數值格式字串和自訂數值格式字串。
如需格式化的詳細資訊，請參閱格式化類型。

參數 provider 是實作 IFormatProvider 。其 GetFormat 方法會 NumberFormatInfo 傳回物件，提供這個方法所傳回之字串格式的文化特性特定資訊。 ToString(String, IFormatProvider)叫用方法時，它會呼叫 provider 參數的方法，並傳遞 Type 代表 NumberFormatInfo 型別的 IFormatProvider.GetFormat 物件。 GetFormat然後，方法會 NumberFormatInfo 傳回物件，提供格式化目前 UInt16 值的資訊，例如群組分隔符號或小數點符號。有三種方式可以使用 provider 參數，將格式資訊 ToString(String, IFormatProvider) 提供給方法：

您可以傳遞 CultureInfo 物件，此物件代表提供格式化資訊的文化特性。其 GetFormat 方法會傳 NumberFormatInfo 回物件，提供該文化特性的數值格式資訊。
您可以傳遞提供數值格式資訊的實際 NumberFormatInfo 物件。 (其實作 GetFormat 只會傳回本身。)
您可以傳遞實作的 IFormatProvider 自訂物件。其 GetFormat 方法會具現化並傳回 NumberFormatInfo 提供格式資訊的物件。

如果 provider 為 null ，則傳回字串的格式設定是以目前文化特性的物件為基礎 NumberFormatInfo 。

另請參閱

適用於

ToString()

Source:: UInt16.cs

Source:: UInt16.cs

Source:: UInt16.cs

將這個執行個體的數值轉換為其相等字串表示。

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

傳回

String

這個執行個體值的字串表示，由 0 到 9 的數字順序所組成，沒有正負號或為零的前置字元。

範例

下列範例會使用預設 ToString() 方法顯示 UInt16 值。它也會顯示使用某些標準格式規範所產生的值的字串表示 UInt16 。這些範例會使用 en-US 文化特性的格式設定慣例來顯示。

using System;

public class Example
{
   public static void Main()
   {
      ushort value = 16324;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());      
      Console.WriteLine();
      
      // Define an array of format specifiers.
      string[] formats = { "G", "C", "D", "F", "N", "X" };
      // Display value using the standard format specifiers.
      foreach (string format in formats)
         Console.WriteLine("{0} format specifier: {1,12}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       16324
//
//       G format specifier:        16324
//       C format specifier:   $16,324.00
//       D format specifier:        16324
//       F format specifier:     16324.00
//       N format specifier:    16,324.00
//       X format specifier:         3FC4

let value = 16324us
// Display value using default ToString method.
printfn $"{value.ToString()}\n"     

// Define an array of format specifiers.
let formats = [| "G"; "C"; "D"; "F"; "N"; "X" |]
// Display value using the standard format specifiers.
for format in formats do
    printfn $"{format} format specifier: {value.ToString format,12}" 
// The example displays the following output:
//       16324
//
//       G format specifier:        16324
//       C format specifier:   $16,324.00
//       D format specifier:        16324
//       F format specifier:     16324.00
//       N format specifier:    16,324.00
//       X format specifier:         3FC4

Module Example
   Public Sub Main()
      Dim value As UInt16 = 16324
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            
      Console.WriteLine()
      
      ' Define an array of format specifiers.
      Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
      ' Display value using the standard format specifiers.
      For Each format As String In formats
         Console.WriteLine("{0} format specifier: {1,12}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' The example displays the following output:
'       16324
'       
'       G format specifier:        16324
'       C format specifier:   $16,324.00
'       D format specifier:        16324
'       F format specifier:     16324.00
'       N format specifier:    16,324.00
'       X format specifier:         3FC4

備註

方法 UInt16 會 ToString() 使用 NumberFormatInfo 目前文化特性的物件，格式化預設 (「G」中的值，或一般) 格式。如果您想要指定不同的格式或文化特性，請使用方法的其他多載 ToString ，如下所示：

使用格式	針對文化特性	使用多載
預設 (「G」) 格式	特定文化特性	ToString(IFormatProvider)
特定格式	預設 (目前) 文化特性	ToString(String)
特定格式	特定文化特性	ToString(String, IFormatProvider)

另請參閱

適用於

UInt16.ToString 方法

定義

多載

ToString(IFormatProvider)

參數

傳回

實作

範例

備註

另請參閱

適用於

ToString(String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

ToString(String, IFormatProvider)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

ToString()

傳回

範例

備註

另請參閱

適用於

意見反應

其他資源