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:
 System::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.

戻り値

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) メソッドは、指定されたカルチャの NumberFormatInfo オブジェクトを使用して、UInt64 値を既定値 ("G" または一般) 形式で書式設定します。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. ただし、一般的な数値書式指定子 ("G") を使用して書式設定する場合、NumberFormatInfo のどのプロパティも使用されません。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);
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.

戻り値

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

実装

例外

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

次の例では、標準の数値書式指定子といくつかの特定の CultureInfo オブジェクトを使用して、32ビットの符号なし整数値を表示します。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) メソッドは、指定されたカルチャの NumberFormatInfo オブジェクトを使用して、指定された書式で UInt64 値を書式設定します。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. formatString.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 メソッドを呼び出し、NumberFormatInfo 型を表す Type オブジェクトに渡します。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 メソッドは、桁区切り記号や小数点の記号など、現在の UInt64 値の書式設定に関する情報を提供する NumberFormatInfo オブジェクトを返します。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 パラメーターを使用して、ToString(String, IFormatProvider) メソッドに書式情報を提供するには、次の3つの方法があります。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.

providernull場合、返される文字列の書式設定は、現在のカルチャの 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);
override this.ToString : string -> string
Public Function ToString (format As String) As String

パラメーター

format
String

数値書式指定文字列。A numeric format 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) メソッドは、現在のカルチャの規則を表す NumberFormatInfo オブジェクトを使用して、指定した書式で UInt64 値を書式設定します。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. formatString.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

戻り値

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.

次の例では、既定の ToString() メソッドを使用して UInt64 値を表示します。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() メソッドは、現在のカルチャの NumberFormatInfo オブジェクトを使用して、UInt64 値を既定値 ("G" または一般) 形式で書式設定します。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)

こちらもご覧ください

適用対象