UInt64.ToString メソッド

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

ToString()

ソース:: UInt64.cs

ソース:: UInt64.cs

ソース:: UInt64.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() メソッドを使用して UInt64 値を表示します。また、一部の標準書式指定子を使用した結果の 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

let value = 163249057uL
// 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,16}" 
// 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() メソッドは、現在のカルチャの NumberFormatInfo オブジェクトを使用して、既定の ("G"、または一般) 形式で UInt64 値を書式設定します。別の形式またはカルチャを指定する場合は、次のように、ToString メソッドの他のオーバーロードを使用します。

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

こちらもご覧ください

Parse(String)
.NET の書式設定の種類

適用対象

ToString(IFormatProvider)

ソース:: UInt64.cs

ソース:: UInt64.cs

ソース:: UInt64.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)

例

次の例では、インバリアントカルチャ用の 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

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 = 18709243uL

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

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

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

こちらもご覧ください

Parse(String)
.NET の書式設定の種類

適用対象

ToString(String)

ソース:: UInt64.cs

ソース:: UInt64.cs

ソース:: UInt64.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 パラメーターが無効です。

例

次の例では、各標準書式指定文字列といくつかのカスタム書式指定文字列を使用して、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

let value = 217960834uL
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: 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) メソッドは、現在のカルチャの規則を表す NumberFormatInfo オブジェクトを使用して、指定した形式で UInt64 値を書式設定します。既定の ("G"、または一般) 形式を使用する場合、または別のカルチャを指定する場合は、次のように、ToString メソッドの他のオーバーロードを使用します。

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

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

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

数値書式指定子の詳細については、「標準の数値書式指定文字列のとカスタム数値書式指定文字列する」を参照してください。
.NET での書式設定のサポートの詳細については、「書式設定の種類を参照してください。

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

こちらもご覧ください

適用対象

ToString(String, IFormatProvider)

ソース:: UInt64.cs

ソース:: UInt64.cs

ソース:: UInt64.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 オブジェクトの数を使用して、32 ビット符号なし整数値を表示します。

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

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 = 22224021uL

for specifier in specifiers do
    for culture in cultures do
        printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 18}"
    printfn ""
// 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) メソッドは、指定したカルチャの NumberFormatInfo オブジェクトを使用して、指定した形式で UInt64 値を書式設定します。既定の形式またはカルチャ設定を使用する場合は、次のように、ToString メソッドの他のオーバーロードを使用します。

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

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

数値書式指定子の詳細については、「標準の数値書式指定文字列のとカスタム数値書式指定文字列する」を参照してください。
書式設定の詳細については、「書式設定の種類」を参照してください。

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

書式設定情報を提供するカルチャを表す CultureInfo オブジェクトを渡すことができます。その GetFormat メソッドは、そのカルチャの数値書式情報を提供する NumberFormatInfo オブジェクトを返します。
数値書式情報を提供する実際の NumberFormatInfo オブジェクトを渡すことができます。 (GetFormat の実装はそれ自体を返すだけです)。
IFormatProviderを実装するカスタムオブジェクトを渡すことができます。その GetFormat メソッドは、書式設定情報を提供する NumberFormatInfo オブジェクトをインスタンス化して返します。

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

こちらもご覧ください

Parse(String)
.NET の書式設定の種類
方法: 先頭にゼロを付けて数値を埋める
サンプル: .NET Core WinForms Formatting Utility (C#)
サンプル: .NET Core WinForms Formatting Utility (Visual Basic)

適用対象

次の方法で共有

UInt64.ToString メソッド

定義

オーバーロード

ToString()

戻り値

例

注釈

こちらもご覧ください

適用対象

ToString(IFormatProvider)

パラメーター

戻り値

実装

例

注釈

こちらもご覧ください

適用対象

ToString(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ToString(String, IFormatProvider)

パラメーター

戻り値

実装

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース