UInt64.ToString UInt64.ToString UInt64.ToString UInt64.ToString Method

定義

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

オーバーロード

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

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

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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) ToString(String) ToString(String) ToString(String)

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

ToString() ToString() ToString() ToString()

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

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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 string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

パラメーター

provider
IFormatProvider IFormatProvider IFormatProvider 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.

実装

次の例では、インバリアント カルチャのいずれかを含め、いくつかの書式プロバイダーを使用して 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 ("G"または [全般]) の既定の値形式を使用して、NumberFormatInfo特定のカルチャ オブジェクト。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) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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 String String String

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

provider
IFormatProvider IFormatProvider IFormatProvider 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.

次の例では、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パラメーターに任意の有効なできますStandard Numeric Format Strings、または任意の組み合わせのカスタム数値書式指定文字列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. 3 つの方法を使用する、providerを書式設定情報を指定するパラメーター、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.

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

こちらもご覧ください

ToString(String) ToString(String) ToString(String) 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 String String 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)メソッド形式、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パラメーターに任意の有効なできますStandard Numeric Format Strings、または任意の組み合わせのカスタム数値書式指定文字列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() ToString() ToString() 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.

次の例では、表示、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"または [全般]) の既定の値形式を使用して、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)
こちらもご覧ください

適用対象