英語で読む

次の方法で共有


UInt16.ToString メソッド

定義

このインスタンスの数値を、それと等価な文字列形式に変換します。

オーバーロード

ToString(IFormatProvider)

このインスタンスの数値を、指定したカルチャ固有の書式情報を使用して、それと等価な文字列形式に変換します。

ToString(String)

このインスタンスの数値を、指定した書式を使用して、それと等価な文字列形式に変換します。

ToString(String, IFormatProvider)

このインスタンスの数値を、指定した書式およびカルチャ固有の書式情報を使用して、それと等価な文字列形式に変換します。

ToString()

このインスタンスの数値を、それと等価な文字列形式に変換します。

ToString(IFormatProvider)

ソース:
UInt16.cs
ソース:
UInt16.cs
ソース:
UInt16.cs

このインスタンスの数値を、指定したカルチャ固有の書式情報を使用して、それと等価な文字列形式に変換します。

C#
public string ToString (IFormatProvider provider);
C#
public string ToString (IFormatProvider? provider);

パラメーター

provider
IFormatProvider

カルチャ固有の書式情報を提供するオブジェクト。

戻り値

0 から 9 までの一連の数字で構成され、符号も先行ゼロも含まない、このインスタンスの値の文字列形式。

実装

次の例では、インバリアント カルチャ用の 1 つを含む複数の書式プロバイダーを使用して、16 ビット符号付き整数値の書式を設定します。 この例の出力は、 メソッドによって ToString(IFormatProvider) 返される書式設定された文字列が、書式プロバイダーに関係なく同じであることを示しています。

C#
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

注釈

メソッドは ToString(IFormatProvider)UInt16 指定したカルチャの オブジェクトを使用 NumberFormatInfo して、既定の ("G"、または一般的な) 形式で値を書式設定します。 別の形式または現在のカルチャを指定する場合は、次のように メソッドの他のオーバーロードを ToString 使用します。

書式を使用するには カルチャの場合 オーバーロードを使用する
既定 ("G") 形式 既定の (現在の) カルチャ ToString()
特定の形式 既定の (現在の) カルチャ ToString(String)
特定の形式 特定のカルチャ ToString(String, IFormatProvider)

パラメーターは provider 実装です IFormatProvider 。 そのメソッドは GetFormat 、カルチャ固有の NumberFormatInfo 書式設定情報を提供する オブジェクトを返します。 ただし、 のプロパティ NumberFormatInfo は、一般的な数値書式指定子 ("G") で書式設定する場合には使用しません。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

ソース:
UInt16.cs
ソース:
UInt16.cs
ソース:
UInt16.cs

このインスタンスの数値を、指定した書式を使用して、それと等価な文字列形式に変換します。

C#
public string ToString (string format);
C#
public string ToString (string? format);

パラメーター

format
String

数値書式指定文字列。

戻り値

format で指定された、このインスタンスの値の文字列形式。

例外

format パラメーターが正しくありません。

次の例では、各標準書式指定文字列といくつかのカスタム書式指定文字列を使用して、16 ビット符号なし整数値を表示します。

C#
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

注釈

メソッドは ToString(String) 、現在の UInt16 カルチャの規則を表す オブジェクトを NumberFormatInfo 使用して、指定した形式で値を書式設定します。 既定の ("G"、または一般的な) 形式を使用する場合、または別のカルチャを指定する場合は、次のように メソッドの他のオーバーロードを ToString 使用します。

書式を使用するには カルチャの場合 オーバーロードを使用する
既定 ("G") 形式 既定の (現在の) カルチャ ToString()
既定 ("G") 形式 特定のカルチャ ToString(IFormatProvider)
特定の形式 特定のカルチャ ToString(String, IFormatProvider)

パラメーターには format 、任意の有効な 標準数値書式指定子、または カスタム数値書式指定子の任意の組み合わせを指定できます。 が String.Empty または の場合formatnull現在UInt16のオブジェクトの戻り値は一般的な書式指定子 ("G") で書式設定されます。 が他の値である場合 format 、メソッドは を FormatExceptionスローします。

.NET では、広範な書式設定のサポートが提供されています。詳細については、次の書式設定に関するトピックを参照してください。

返される文字列の形式は、現在のカルチャの NumberFormatInfo オブジェクトによって決まります。 パラメーターに format 応じて、このオブジェクトは、出力文字列内のグループ区切り記号や小数点記号などのシンボルを制御します。 現在のカルチャ以外のカルチャの書式設定情報を提供するには、 オーバーロードを ToString(String, IFormatProvider) 呼び出します。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

ソース:
UInt16.cs
ソース:
UInt16.cs
ソース:
UInt16.cs

このインスタンスの数値を、指定した書式およびカルチャ固有の書式情報を使用して、それと等価な文字列形式に変換します。

C#
public string ToString (string format, IFormatProvider provider);
C#
public string ToString (string? format, IFormatProvider? provider);

パラメーター

format
String

数値書式指定文字列。

provider
IFormatProvider

カルチャ固有の書式情報を提供するオブジェクト。

戻り値

formatproviderで指定された、このインスタンスの値の文字列形式。

実装

例外

format が無効です。

次の例では、標準の数値書式指定子と特定 CultureInfo のオブジェクトの数を使用して、16 ビット符号なし整数値を表示します。

C#
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

注釈

メソッドは ToString(String, IFormatProvider)UInt16 指定したカルチャの オブジェクトを使用して、 NumberFormatInfo 指定した形式で値を書式設定します。 既定の形式またはカルチャ設定を使用する場合は、次のように メソッドの他のオーバーロードを ToString 使用します。

書式を使用するには カルチャの場合 オーバーロードを使用する
既定 ("G") 形式 既定の (現在の) カルチャ ToString()
既定 ("G") 形式 特定のカルチャ ToString(IFormatProvider)
特定の形式 既定の (現在の) カルチャ ToString(String)

パラメーターには format 、任意の有効な 標準数値書式指定文字列、または カスタム数値書式指定文字列の任意の組み合わせを指定できます。 が String.Empty または の場合formatnull現在UInt16のオブジェクトの戻り値は一般的な書式指定子 ("G") で書式設定されます。 が他の値である場合 format 、メソッドは を FormatExceptionスローします。

.NET では、広範な書式設定のサポートが提供されています。詳細については、次の書式設定に関するトピックを参照してください。

パラメーターは provider 実装です IFormatProvider 。 そのメソッドは GetFormatNumberFormatInfo このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供する オブジェクトを返します。 メソッドがToString(String, IFormatProvider)呼び出されると、パラメーターの IFormatProvider.GetFormat メソッドをprovider呼び出し、型をType表すオブジェクトをNumberFormatInfo渡します。 次に、 メソッドはGetFormat、グループ区切り記号や小数点記号など、現在UInt16の値を書式設定するための情報を提供する オブジェクトを返NumberFormatInfoします。 パラメーターを使用 provider して、 メソッドに書式設定情報を指定するには、次の ToString(String, IFormatProvider) 3 つの方法があります。

  • 書式設定情報を CultureInfo 提供するカルチャを表す オブジェクトを渡すことができます。 そのメソッドは GetFormat 、そのカルチャの NumberFormatInfo 数値書式情報を提供する オブジェクトを返します。

  • 数値書式情報を提供する実際 NumberFormatInfo のオブジェクトを渡すことができます。 (の実装 GetFormat は、それ自体を返すだけです)。

  • を実装 IFormatProviderするカスタム オブジェクトを渡すことができます。 そのメソッドは GetFormat 、書式設定情報を提供する オブジェクトを NumberFormatInfo インスタンス化して返します。

が の場合provider、返される文字列の書式設定は、現在のカルチャの NumberFormatInfo オブジェクトに基nullづきます。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString()

ソース:
UInt16.cs
ソース:
UInt16.cs
ソース:
UInt16.cs

このインスタンスの数値を、それと等価な文字列形式に変換します。

C#
public override string ToString ();

戻り値

0 から 9 までの一連の数字で構成され、符号も先行ゼロも含まない、このインスタンスの値の文字列形式。

次の例では、既定ToString()のメソッドをUInt16使用して値を表示します。 また、一部の標準書式指定子を UInt16 使用した結果の値の文字列表現も表示されます。 例は、en-US カルチャの書式設定規則を使用して表示されます。

C#
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

注釈

メソッドは ToString() 、現在の UInt16 カルチャの オブジェクトを使用 NumberFormatInfo して、既定の ("G"、または一般) 形式で値の書式を設定します。 別の形式またはカルチャを指定する場合は、次のように メソッドの他のオーバーロードを ToString 使用します。

形式を使用するには カルチャの場合 オーバーロードを使用する
既定の ("G") 形式 特定のカルチャ ToString(IFormatProvider)
特定の形式 既定の (現在の) カルチャ ToString(String)
特定の形式 特定のカルチャ ToString(String, IFormatProvider)

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0