UInt64.ToString メソッド

定義

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

オーバーロード

ToString(IFormatProvider)

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

ToString(String, IFormatProvider)

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

ToString(String)

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

ToString()

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

ToString(IFormatProvider)

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

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 までの一連の数字から構成され、符号または先行ゼロを含まない、このインスタンスの値の文字列形式。

実装

次の例では、インバリアント カルチャ用に 1 つを含む複数の書式プロバイダーを使用して、64 ビット符号付き整数値を書式設定します。 この例の出力は、 メソッドによって返される書式設定された文字列が、書式プロバイダーに関係なく同 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 }; 
      ulong value = 18709243;
      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
//          18709243       18709243       18709243
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 ULong = 18709243
      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
'          18709243       18709243       18709243

注釈

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

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

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

こちらもご覧ください

適用対象

ToString(String, IFormatProvider)

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

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 で指定された、このインスタンスの値の文字列形式。

実装

例外

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

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

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"};
      ulong value = 22224021;

      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}",
                              specifier, culture.Name,
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:           22224021
//        G format using fr-FR culture:           22224021
//        G format using es-ES culture:           22224021
//
//        C format using en-US culture:     $22,224,021.00
//        C format using fr-FR culture:    22 224 021,00 €
//        C format using es-ES culture:    22.224.021,00 €
//
//       D4 format using en-US culture:           22224021
//       D4 format using fr-FR culture:           22224021
//       D4 format using es-ES culture:           22224021
//
//       E2 format using en-US culture:          2.22E+007
//       E2 format using fr-FR culture:          2,22E+007
//       E2 format using es-ES culture:          2,22E+007
//
//        F format using en-US culture:        22224021.00
//        F format using fr-FR culture:        22224021,00
//        F format using es-ES culture:        22224021,00
//
//        N format using en-US culture:      22,224,021.00
//        N format using fr-FR culture:      22 224 021,00
//        N format using es-ES culture:      22.224.021,00
//
//        P format using en-US culture: 2,222,402,100.00 %
//        P format using fr-FR culture: 2 222 402 100,00 %
//        P format using es-ES culture: 2.222.402.100,00 %
//
//       X2 format using en-US culture:            1531C95
//       X2 format using fr-FR culture:            1531C95
//       X2 format using es-ES culture:            1531C95
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 ULong = 22224021

      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}", _
                              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:           22224021
'        G format using fr-FR culture:           22224021
'        G format using es-ES culture:           22224021
'
'        C format using en-US culture:     $22,224,021.00
'        C format using fr-FR culture:    22 224 021,00 €
'        C format using es-ES culture:    22.224.021,00 €
'
'       D4 format using en-US culture:           22224021
'       D4 format using fr-FR culture:           22224021
'       D4 format using es-ES culture:           22224021
'
'       E2 format using en-US culture:          2.22E+007
'       E2 format using fr-FR culture:          2,22E+007
'       E2 format using es-ES culture:          2,22E+007
'
'        F format using en-US culture:        22224021.00
'        F format using fr-FR culture:        22224021,00
'        F format using es-ES culture:        22224021,00
'
'        N format using en-US culture:      22,224,021.00
'        N format using fr-FR culture:      22 224 021,00
'        N format using es-ES culture:      22.224.021,00
'
'        P format using en-US culture: 2,222,402,100.00 %
'        P format using fr-FR culture: 2 222 402 100,00 %
'        P format using es-ES culture: 2.222.402.100,00 %
'
'       X2 format using en-US culture:            1531C95
'       X2 format using fr-FR culture:            1531C95
'       X2 format using es-ES culture:            1531C95

注釈

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

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

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

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

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

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

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

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

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

こちらもご覧ください

適用対象

ToString(String)

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

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 で指定された、このインスタンスの値の文字列形式。

例外

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

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

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      ulong value = 217960834;
      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: 217960834
//       C: $217,960,834.00
//       D3: 217960834
//       E2: 2.18E+008
//       e3: 2.180e+008
//       F: 217960834.00
//       N: 217,960,834.00
//       P: 21,796,083,400.00 %
//       X: CFDD182
//       000000.0: 217960834.0
//       #.0: 217960834.0
//       00000000;(0);**Zero**: 217960834
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As ULong = 217960834 
      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: 217960834
'       C: $217,960,834.00
'       D3: 217960834
'       E2: 2.18E+008
'       e3: 2.180e+008
'       F: 217960834.00
'       N: 217,960,834.00
'       P: 21,796,083,400.00 %
'       X: CFDD182
'       000000.0: 217960834.0
'       #.0: 217960834.0
'       00000000;(0);**Zero**: 217960834

注釈

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

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

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

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

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

こちらもご覧ください

適用対象

ToString()

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

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

戻り値

String

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

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

using System;

public class Example
{
   public static void Main()
   {
      ulong value = 163249057;
      // 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,16}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       163249057
//       
//       G format specifier:        163249057
//       C format specifier:  $163,249,057.00
//       D format specifier:        163249057
//       F format specifier:     163249057.00
//       N format specifier:   163,249,057.00
//       X format specifier:          9BAFBA1
Module Example
   Public Sub Main()
      Dim value As ULong = 163249057
      ' 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,16}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' The example displays the following output:
'       163249057
'       
'       G format specifier:        163249057
'       C format specifier:  $163,249,057.00
'       D format specifier:        163249057
'       F format specifier:     163249057.00
'       N format specifier:   163,249,057.00
'       X format specifier:          9BAFBA1

注釈

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

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

こちらもご覧ください

適用対象