UInt16.ToString 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

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

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

多載

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

ToString(IFormatProvider)

來源:: UInt16.cs

來源:: UInt16.cs

來源:: 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

備註

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

使用格式	針對文化特性	使用多載
默認 (“G”) 格式	默認 (目前) 文化特性	ToString()
特定格式	默認 (目前) 文化特性	ToString(String)
特定格式	特定文化特性	ToString(String, IFormatProvider)

參數 provider 是實作 IFormatProvider 。其 GetFormat 方法會傳回提供 NumberFormatInfo 特定文化特性格式信息的物件。不過，使用一般數值格式規範格式化時，不會使用的屬性 NumberFormatInfo (“G”) 。

另請參閱

適用於

ToString(String)

來源:: UInt16.cs

來源:: UInt16.cs

來源:: 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)

來源:: UInt16.cs

來源:: UInt16.cs

來源:: 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 參數的 IFormatProvider.GetFormat 方法，並傳遞Type代表型別的 NumberFormatInfo 物件。然後，方法 GetFormat 會傳 NumberFormatInfo 回物件，提供格式化目前 UInt16 值的資訊，例如群組分隔符符號或小數點符號。有三種方式可以使用 provider 參數，將格式資訊 ToString(String, IFormatProvider) 提供給方法：

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

如果為 providernull，則傳回字串的格式會以目前文化特性的對象為基礎 NumberFormatInfo 。

另請參閱

適用於

ToString()

來源:: UInt16.cs

來源:: UInt16.cs

來源:: 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

備註

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

若要使用格式	針對文化特性	使用多載
默認 (“G”) 格式	特定文化特性	ToString(IFormatProvider)
特定格式	默認 (目前) 文化特性	ToString(String)
特定格式	特定文化特性	ToString(String, IFormatProvider)

另請參閱

適用於

共用方式為

UInt16.ToString 方法

定義

多載

ToString(IFormatProvider)

參數

傳回

實作

範例

備註

另請參閱

適用於

ToString(String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

ToString(String, IFormatProvider)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

ToString()

傳回

範例

備註

另請參閱

適用於

其他資源