UInt64.ToString メソッド

定義

このインスタンスの数値を、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation.

オーバーロード

ToString(IFormatProvider)

このインスタンスの数値を、指定したカルチャ固有の書式情報を使用して、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

このインスタンスの数値を、指定した書式およびカルチャ固有の書式情報を使用して、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String)

このインスタンスの数値を、指定した書式を使用して、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation using the specified format.

ToString()

このインスタンスの数値を、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

このインスタンスの数値を、指定したカルチャ固有の書式情報を使用して、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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

カルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information.

戻り値

String

0 から 9 までの一連の数字から構成され、符号または先行ゼロを含まない、このインスタンスの値の文字列形式。The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

実装

次の例では、インバリアントカルチャに対して1つを含む、複数の書式プロバイダーを使用して、64ビット符号付き整数値の書式を設定します。The following example formats a 64-bit signed integer value by using several format providers, including one for the invariant culture. この例の出力は、書式プロバイダーに関係なく、メソッドによって返される書式設定された文字列が同じであることを示してい ToString(IFormatProvider) ます。The output from the example illustrates that the formatted string returned by the ToString(IFormatProvider) method is the same regardless of the format provider.

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 NumberFormatInfo 指定されたカルチャのオブジェクトを使用して、既定の ("G" または "general") 形式の値を書式設定します。The ToString(IFormatProvider) method formats a UInt64 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. 別の形式または現在のカルチャを指定する場合は、次のようにメソッドの他のオーバーロードを使用し ToString ます。If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

形式を使用するにはTo use format カルチャの場合For culture オーバーロードを使用するUse the overload
既定 ("G") 形式Default ("G") format 既定の (現在の) カルチャDefault (current) culture ToString()
特定の形式A specific format 既定の (現在の) カルチャDefault (current) culture ToString(String)
特定の形式A specific format 特定のカルチャA specific culture ToString(String, IFormatProvider)

providerパラメーターは、の IFormatProvider 実装です。The provider parameter is an IFormatProvider implementation. この GetFormat メソッドは、 NumberFormatInfo カルチャ固有の書式情報を提供するオブジェクトを返します。Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. ただし、 NumberFormatInfo 標準の数値書式指定子 ("G") を使用して書式設定する場合、のプロパティは使用されません。However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

こちらもご覧ください

適用対象

ToString(String, IFormatProvider)

このインスタンスの数値を、指定した書式およびカルチャ固有の書式情報を使用して、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

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

数値書式指定文字列。A numeric format string.

provider
IFormatProvider

このインスタンスに関するカルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information about this instance.

戻り値

String

format および provider で指定された、このインスタンスの値の文字列形式。The string representation of the value of this instance as specified by format and provider.

実装

例外

format パラメーターが正しくありません。The format parameter is invalid.

次の例では、標準の数値書式指定子といくつかの特定のオブジェクトを使用して、32ビットの符号なし整数値を表示し CultureInfo ます。The following example displays a 32-bit unsigned integer value by using the standard numeric format specifiers and a number of specific CultureInfo objects.

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 ます。The ToString(String, IFormatProvider) method formats a UInt64 value in a specified format by using the NumberFormatInfo object of a specified culture. 既定の書式設定またはカルチャ設定を使用する場合は、次のようにメソッドの他のオーバーロードを使用し ToString ます。If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

形式を使用するにはTo use format カルチャの場合For culture オーバーロードを使用するUse the overload
既定 ("G") 形式Default ("G") format 既定の (現在の) カルチャDefault (current) culture ToString()
既定 ("G") 形式Default ("G") format 特定のカルチャA specific culture ToString(IFormatProvider)
特定の形式A specific format 既定の (現在の) カルチャDefault (current) culture ToString(String)

パラメーターには、 format 任意の有効な 標準の数値書式指定文字列、またはカスタムの 数値書式指定文字列の任意の組み合わせを指定できます。The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. formatがまたはに等しい場合 String.Empty null 、現在のオブジェクトの戻り値 UInt64 は、一般書式指定子 ("G") で書式設定されます。If format is equal to String.Empty or is null, the return value of the current UInt64 object is formatted with the general format specifier ("G"). formatがその他の値の場合、メソッドはをスロー FormatException します。If format is any other value, the method throws a FormatException.

.NET Framework では、さまざまな書式設定がサポートされています。詳細については、次の書式設定に関するトピックを参照してください。The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

providerパラメーターは、の IFormatProvider 実装です。The provider parameter is an IFormatProvider implementation. このメソッドは、 GetFormat NumberFormatInfo このメソッドによって返される文字列の書式に関するカルチャ固有の情報を提供するオブジェクトを返します。Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. ToString(String, IFormatProvider)メソッドが呼び出されると、 provider パラメーターのメソッドを呼び出し、型を IFormatProvider.GetFormat Type 表すオブジェクトを渡し NumberFormatInfo ます。When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's IFormatProvider.GetFormat method and passes it a Type object that represents the NumberFormatInfo type. 次に、メソッドは、 GetFormat NumberFormatInfo グループの区切り記号 UInt64 や小数点の記号など、現在の値の書式設定に関する情報を提供するオブジェクトを返します。The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the current UInt64 value, such as the group separator symbol or the decimal point symbol. パラメーターを使用して provider 、メソッドに書式情報を提供するには、次の3つの方法があり ToString(String, IFormatProvider) ます。There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • CultureInfo書式設定情報を提供するカルチャを表すオブジェクトを渡すことができます。You can pass a CultureInfo object that represents the culture that supplies formatting information. その GetFormat メソッドは、 NumberFormatInfo そのカルチャに対して数値の書式設定情報を提供するオブジェクトを返します。Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • NumberFormatInfo数値の書式設定情報を提供する実際のオブジェクトを渡すことができます。You can pass the actual NumberFormatInfo object that provides numeric formatting information. (の実装では、 GetFormat だけが返されます)。(Its implementation of GetFormat just returns itself.)

  • を実装するカスタムオブジェクトを渡すことができ IFormatProvider ます。You can pass a custom object that implements IFormatProvider. この GetFormat メソッドは、 NumberFormatInfo 書式設定情報を提供するオブジェクトをインスタンス化して返します。Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

がの場合 provider null 、返される文字列の書式設定は、現在のカルチャのオブジェクトに基づいてい NumberFormatInfo ます。If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

こちらもご覧ください

適用対象

ToString(String)

このインスタンスの数値を、指定した書式を使用して、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation using the specified format.

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

数値書式指定文字列。A numeric format string.

戻り値

String

format で指定された、このインスタンスの値の文字列形式。The string representation of the value of this instance as specified by format.

例外

format パラメーターが正しくありません。The format parameter is invalid.

次の例では、各標準書式指定文字列といくつかのカスタム書式指定文字列を使用して、64ビットの符号なし整数値を表示します。The following example displays a 64-bit unsigned integer value by using each standard format string and some custom format strings.

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 カルチャの規則を表すオブジェクトを使用して、指定した書式で値の書式を設定します。The ToString(String) method formats a UInt64 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. 既定の形式 ("G" または一般) を使用する場合、または別のカルチャを指定する場合は、次のようにメソッドの他のオーバーロードを使用し ToString ます。If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

形式を使用するにはTo use format カルチャの場合For culture オーバーロードを使用するUse the overload
既定 ("G") 形式Default ("G") format 既定の (現在の) カルチャDefault (current) culture ToString()
既定 ("G") 形式Default ("G") format 特定のカルチャA specific culture ToString(IFormatProvider)
特定の形式A specific format 特定のカルチャA specific culture ToString(String, IFormatProvider)

パラメーターには、 format 任意の有効な 標準の数値書式指定文字列、またはカスタムの 数値書式指定文字列の任意の組み合わせを指定できます。The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. formatがまたはに等しい場合 String.Empty null 、現在のオブジェクトの戻り値 UInt64 は、一般書式指定子 ("G") で書式設定されます。If format is equal to String.Empty or is null, the return value of the current UInt64 object is formatted with the general format specifier ("G"). formatがその他の値の場合、メソッドはをスロー FormatException します。If format is any other value, the method throws a FormatException.

.NET Framework では、さまざまな書式設定がサポートされています。詳細については、次の書式設定に関するトピックを参照してください。The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

返される文字列の形式は、現在のカルチャのオブジェクトによって決定され NumberFormatInfo ます。The format of the returned string is determined by the NumberFormatInfo object for the current culture. パラメーターに応じて format 、このオブジェクトは、出力文字列内の区切り記号や小数点の記号などの記号を制御します。Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. 現在のカルチャ以外のカルチャの書式設定情報を提供するには、オーバーロードを呼び出し ToString(String, IFormatProvider) ます。To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

こちらもご覧ください

適用対象

ToString()

このインスタンスの数値を、それと等価な文字列形式に変換します。Converts the numeric value of this instance to its equivalent string representation.

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

戻り値

String

0 から 9 までの一連の数字から構成され、符号または先行ゼロを含まない、このインスタンスの値の文字列形式。The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeroes.

次の例では、 UInt64 既定のメソッドを使用して値を表示し ToString() ます。The following example displays a UInt64 value by using the default ToString() method. また、 UInt64 一部の標準書式指定子を使用した結果得られる値の文字列形式も表示されます。It also displays the string representations of the UInt64 value that results from using some standard format specifiers. これらの例は、en-us カルチャの書式指定規則を使用して表示されます。The examples are displayed using the formatting conventions of the en-US culture.

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" または "general") 形式の値を書式設定し NumberFormatInfo ます。The ToString() method formats a UInt64 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. 別の形式またはカルチャを指定する場合は、次のようにメソッドの他のオーバーロードを使用し ToString ます。If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

形式を使用するにはTo use format カルチャの場合For culture オーバーロードを使用するUse the overload
既定 ("G") 形式Default ("G") format 特定のカルチャA specific culture ToString(IFormatProvider)
特定の形式A specific format 既定の (現在の) カルチャDefault (current) culture ToString(String)
特定の形式A specific format 特定のカルチャA specific culture ToString(String, IFormatProvider)

こちらもご覧ください

適用対象