Int64.ToString Int64.ToString Int64.ToString Int64.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:
 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

カルチャ固有の書式情報を提供する IFormatProviderAn IFormatProvider that supplies culture-specific formatting information.

戻り値

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

実装

次の例では、複数の異なるInt64カルチャをCultureInfo表すオブジェクトを使用して、値の文字列形式を表示します。The following example displays the string representation of an Int64 value using CultureInfo objects that represent several different cultures.

long value = -16325901;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325901
//       -16325901
//       -16325901
Dim value As Long = -16325801
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
'       -16325901
'       -16325901
'       -16325901

注釈

メソッドToString(IFormatProvider)は、指定Int64されたカルチャのNumberFormatInfoオブジェクトを使用して、既定の ("G" または "general") 形式の値を書式設定します。The ToString(IFormatProvider) method formats an Int64 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)

パラメーターは、インターフェイスをIFormatProvider実装するオブジェクトです。 providerThe provider parameter is an object that implements the IFormatProvider interface. このメソッドは、 NumberFormatInfoこのメソッドによって返される文字列の書式に関するカルチャ固有の情報を提供するオブジェクトを返します。 GetFormatIts GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. を実装IFormatProviderするオブジェクトは、次のいずれかになります。The object that implements IFormatProvider can be any of the following:

  • 書式設定規則を使用するカルチャを表すオブジェクト。CultureInfoA CultureInfo object that represents the culture whose formatting rules are to be used.

  • この値の特定の数値書式情報を格納しているオブジェクト。NumberFormatInfoA NumberFormatInfo object that contains specific numeric formatting information for this value.

  • を実装IFormatProviderし、書式設定情報GetFormatを提供するNumberFormatInfoオブジェクトを返すメソッドを持つカスタムオブジェクト。A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

provider NumberFormatInfo NumberFormatInfoであるか、からproviderオブジェクトを取得できない場合、戻り値は現在のカルチャのオブジェクトを使用して書式設定されます。 nullIf provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted with the NumberFormatInfo object for the current culture.

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

こちらもご覧ください

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 は使用できないか、またはサポートされていません。format is invalid or not supported.

次の例では、3つの異なるカルチャに対してサポートされている各標準数値書式指定子を使用して、正の値と負の値を表示します。The following example displays a positive and a negative value using each of the supported standard numeric format specifiers for three different cultures.

// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"), 
                          CultureInfo.CreateSpecificCulture("fr-FR"), 
                          CultureInfo.CreateSpecificCulture("es-ES") };
long positiveNumber = 1679;
long negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}; 

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",  
                        specifier, culture.Name, 
                        positiveNumber.ToString(specifier, culture), 
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//    G format using en-US culture:             1679            -3045
//    G format using fr-FR culture:             1679            -3045
//    G format using es-ES culture:             1679            -3045
//    
//    C format using en-US culture:        $1,679.00      ($3,045.00)
//    C format using fr-FR culture:       1 679,00 ?      -3 045,00 ?
//    C format using es-ES culture:       1.679,00 ?      -3.045,00 ?
//    
//    D8 format using en-US culture:         00001679        -00003045
//    D8 format using fr-FR culture:         00001679        -00003045
//    D8 format using es-ES culture:         00001679        -00003045
//    
//    E2 format using en-US culture:        1.68E+003       -3.05E+003
//    E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//    E2 format using es-ES culture:        1,68E+003       -3,05E+003
//    
//    F format using en-US culture:          1679.00         -3045.00
//    F format using fr-FR culture:          1679,00         -3045,00
//    F format using es-ES culture:          1679,00         -3045,00
//    
//    N format using en-US culture:         1,679.00        -3,045.00
//    N format using fr-FR culture:         1 679,00        -3 045,00
//    N format using es-ES culture:         1.679,00        -3.045,00
//    
//    P format using en-US culture:     167,900.00 %    -304,500.00 %
//    P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//    P format using es-ES culture:     167.900,00 %    -304.500,00 %
//    
//    X8 format using en-US culture:         0000068F         FFFFF41B
//    X8 format using fr-FR culture:         0000068F         FFFFF41B
//    X8 format using es-ES culture:         0000068F         FFFFF41B
' 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 positiveNumber As Long = 1679
Dim negativeNumber As Long = -3045
Dim specifiers() As String = {"G", "C", "D8", "E2", "F", "N", "P", "X8"} 

For Each specifier As String In specifiers
   For Each culture As CultureInfo In Cultures
      ' Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}", _ 
                        specifier, culture.Name, _
                        positiveNumber.ToString(specifier, culture), _
                        negativeNumber.ToString(specifier, culture))

   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'    G format using en-US culture:             1679            -3045
'    G format using fr-FR culture:             1679            -3045
'    G format using es-ES culture:             1679            -3045
'    
'    C format using en-US culture:        $1,679.00      ($3,045.00)
'    C format using fr-FR culture:       1 679,00 ?      -3 045,00 ?
'    C format using es-ES culture:       1.679,00 ?      -3.045,00 ?
'    
'    D8 format using en-US culture:         00001679        -00003045
'    D8 format using fr-FR culture:         00001679        -00003045
'    D8 format using es-ES culture:         00001679        -00003045
'    
'    E2 format using en-US culture:        1.68E+003       -3.05E+003
'    E2 format using fr-FR culture:        1,68E+003       -3,05E+003
'    E2 format using es-ES culture:        1,68E+003       -3,05E+003
'    
'    F format using en-US culture:          1679.00         -3045.00
'    F format using fr-FR culture:          1679,00         -3045,00
'    F format using es-ES culture:          1679,00         -3045,00
'    
'    N format using en-US culture:         1,679.00        -3,045.00
'    N format using fr-FR culture:         1 679,00        -3 045,00
'    N format using es-ES culture:         1.679,00        -3.045,00
'    
'    P format using en-US culture:     167,900.00 %    -304,500.00 %
'    P format using fr-FR culture:     167 900,00 %    -304 500,00 %
'    P format using es-ES culture:     167.900,00 %    -304.500,00 %
'    
'    X8 format using en-US culture:         0000068F         FFFFF41B
'    X8 format using fr-FR culture:         0000068F         FFFFF41B
'    X8 format using es-ES culture:         0000068F         FFFFF41B

注釈

メソッドToString(String, IFormatProvider)は、指定Int64されたカルチャのNumberFormatInfoオブジェクトを使用して、指定された書式で値の書式を設定します。The ToString(String, IFormatProvider) method formats an Int64 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 either a standard or a custom numeric format string. すべてのカスタム数値書式指定文字と同様に、"R" (または "r") 以外のすべての標準の数値書式指定文字列がサポートされます。All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. formatnullまたは空の文字列 ("") の場合、このインスタンスの戻り値は、一般的な数値書式指定子 ("G") で書式設定されます。If format is null or an empty string (""), the return value for this instance is formatted with the general numeric format specifier ("G").

パラメーターは、インターフェイスをIFormatProvider実装するオブジェクトです。 providerThe provider parameter is an object that implements the IFormatProvider interface. このメソッドは、 NumberFormatInfoこのメソッドによって返される文字列の書式に関するカルチャ固有の情報を提供するオブジェクトを返します。 GetFormatIts GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. を実装IFormatProviderするオブジェクトは、次のいずれかになります。The object that implements IFormatProvider can be any of the following:

  • 書式設定規則を使用するカルチャを表すオブジェクト。CultureInfoA CultureInfo object that represents the culture whose formatting rules are to be used.

  • この値の特定の数値書式情報を格納しているオブジェクト。NumberFormatInfoA NumberFormatInfo object that contains specific numeric formatting information for this value.

  • を実装IFormatProviderし、書式設定情報GetFormatを提供するNumberFormatInfoオブジェクトを返すメソッドを持つカスタムオブジェクト。A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

provider NumberFormatInfo NumberFormatInfoであるか、からproviderオブジェクトを取得できない場合、このインスタンスの戻り値は、現在のカルチャので書式設定されます。 nullIf provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value for this instance is formatted with the NumberFormatInfo for the current culture.

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

こちらもご覧ください

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 は使用できないか、またはサポートされていません。format is invalid or not supported.

次の例ではInt64 、サポートされている各標準数値書式指定子と、2つのカスタム数値書式指定文字列を使用して値を表示します。The following example displays an Int64 value using each of the supported standard numeric format specifiers together with two custom numeric format strings. 数値を文字列に変換する場合、この例では en-us カルチャの書式指定規則を使用します。In converting the numeric values to strings, the example uses the formatting conventions of the en-US culture.

long value = -16325;
string specifier;

// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000.0).ToString(specifier));
// Displays:    P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    X: FFFFFFFFFFFFC03B 

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): 16,325.00
Dim value As Long = -16325
Dim specifier As String

' Use standard numeric format specifier.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: -16325
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: ($16,325.00)
specifier = "D8"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    D8: -00016325
specifier = "E4"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E4: -1.6325E+004
specifier = "e3"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    e3: -1.633e+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: -16325.00
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: -16,325.00
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier))
' Displays:    P: -16.33 %
specifier = "X"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    X: FFFFFFFFFFFFC03B

' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays:    #,#.00#;(#,#.00#): 16,325.00

注釈

メソッドToString(String)は、現在Int64のカルチャの規則を表すNumberFormatInfoオブジェクトを使用して、指定した書式で値の書式を設定します。The ToString(String) method formats an Int64 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には、"R" 以外の任意の有効な標準数値書式指定子、およびカスタム数値書式指定子の任意の組み合わせを指定できます。The format parameter can be any valid standard numeric format specifier except for "R", as well as any combination of custom numeric format specifiers. formatnullまたは空の文字列 ("") の場合、このインスタンスの戻り値は、一般的な数値書式指定子 ("G") で書式設定されます。If format is null or an empty string (""), the return value of this instance is formatted with the general numeric format specifier ("G").

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

このインスタンスの戻り値は、 NumberFormatInfo現在のカルチャので書式設定されます。The return value of this instance is formatted with the NumberFormatInfo for the current culture.

こちらもご覧ください

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 minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

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

long value = -16325091;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325091
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325091
Console.WriteLine(value.ToString("C"));         // Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325091
Console.WriteLine(value.ToString("F"));         // Displays -16325091.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325,091.00
Console.WriteLine(value.ToString("X"));         // Displays FFFFFFFFFF06E61D      
Dim value As Long = -16325091
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325091
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325091
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D"))         ' Displays -16325091
Console.WriteLine(value.ToString("F"))         ' Displays -16325091.00
Console.WriteLine(value.ToString("N"))         ' Displays -16,325091.00
Console.WriteLine(value.ToString("X"))         ' Displays FFFFFFFFFF06E61D      

注釈

メソッドToString()は、現在Int64のカルチャのNumberFormatInfoオブジェクトを使用して、既定の ("G" または "general") 形式の値を書式設定します。The ToString() method formats an Int64 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)

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

こちらもご覧ください

適用対象