Int64.ToString Метод

Исходный код:

Int64.cs

Исходный код:

Int64.cs

Исходный код:

Int64.cs

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Возвращаемое значение

Строковое представление значения этого экземпляра, содержащее знак минус, если значение отрицательное, и последовательность цифр в диапазоне от 0 до 9 без нулей в начале.

Примеры

В следующем примере отображается Int64 значение с помощью метода по умолчанию ToString() . Он также отображает строковые представления значения, полученного Int64 в результате использования ряда описателей стандартного формата. Примеры отображаются с использованием соглашений о форматировании языка и региональных параметров en-US.

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("N0"));         // Displays -16,325,091
Console.WriteLine(value.ToString("X"));         // Displays FFFFFFFFFF06E61D

let value = -16325091L
// Display value using default ToString method.
printfn $"{value.ToString()}"            // Displays -16325091
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}"""         // Displays -16325091
printfn $"""{value.ToString "C"}"""         // Displays ($16,325,091.00)
printfn $"""{value.ToString "D"}"""         // Displays -16325091
printfn $"""{value.ToString "F"}"""         // Displays -16325091.00
printfn $"""{value.ToString "N"}"""         // Displays -16,325,091.00
printfn $"""{value.ToString "N0"}"""        // Displays -16,325,091
printfn $"""{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 значение в формате по умолчанию (G или general) с помощью NumberFormatInfo объекта текущего языка и региональных параметров. Если вы хотите указать другой формат или язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:

.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:

• Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки настраиваемого числового формата.

• Дополнительные сведения о форматировании см. в разделе Типы форматирования.

См. также раздел

• Parse(String)
• String
• Типы форматирования в .NET

Исходный код:

Int64.cs

Исходный код:

Int64.cs

Исходный код:

Int64.cs

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Параметры

Возвращаемое значение

Строковое представление значения данного экземпляра, определяемое параметром provider.

Реализации

Примеры

В следующем примере показано строковое Int64 представление значения с помощью CultureInfo объектов, представляющих несколько разных языков и региональных параметров.

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

let value = -16325901L
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB" )}"""
// Display value using the de-DE culture.
printfn $"""{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 значение в формате по умолчанию ("G" или общий) с помощью NumberFormatInfo объекта указанного языка и региональных параметров. Если вы хотите указать другой формат или текущий язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:

Параметр provider — это объект, реализующий IFormatProvider интерфейс . Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о формате строки, возвращаемой этим методом, с учетом языка и региональных параметров. Объект, реализующий , IFormatProvider может быть любым из следующих:

• Объект CultureInfo , представляющий язык и региональные параметры, правила форматирования которых должны использоваться.

• Объект NumberFormatInfo , содержащий определенные числовые сведения о форматировании для этого значения.

• Пользовательский объект, реализующий IFormatProvider и метод которого GetFormat возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.

Если provider имеет значение null или NumberFormatInfo объект не может быть получен из provider, возвращаемое значение форматируется с NumberFormatInfo помощью объекта для текущего языка и региональных параметров.

.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:

• Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки настраиваемого числового формата.

• Дополнительные сведения о форматировании см. в разделе Типы форматирования.

См. также раздел

• Parse(String)
• String
• Типы форматирования в .NET

Исходный код:

Int64.cs

Исходный код:

Int64.cs

Исходный код:

Int64.cs

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Параметры

Возвращаемое значение

Строковое представление значения данного экземпляра, определяемое параметром format.

Исключения

Примеры

В следующем примере отображается Int64 значение с использованием каждого из поддерживаемых описателей стандартного числового формата вместе с двумя строками настраиваемого числового формата. При преобразовании числовых значений в строки в примере используются соглашения о форматировании языка и региональных параметров en-US.

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

let value = -16325L

// Use standard numeric format specifier.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    G: -16325

let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    C: ($16,325.00)

let specifier = "D8"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    D8: -00016325

let specifier = "E4"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    E4: -1.6325E+004

let specifier = "e3"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    e3: -1.633e+004

let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    F: -16325.00

let specifier = "N"
printfn $"{specifier}: {value.ToString specifier }"
// Displays:    N: -16,325.00

let specifier = "P"
printfn $"{specifier}: {(float value / 100000.0).ToString specifier}"
// Displays:    P: -16.33 %

let specifier = "X"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays:    X: FFFFFFFFFFFFC03B

// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString(specifier)}"
// Displays:    0,0.000: -16,325.000

let specifier = "#,#.00#(#,#.00#)"
printfn $"{specifier}: {(value * -1L).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 объекта , представляющего соглашения текущего языка и региональных параметров. Если вы хотите использовать формат по умолчанию ("G" или общий) или указать другой язык и региональные параметры, используйте другие перегрузки ToString метода следующим образом:

Параметр format может быть любым допустимым описателем стандартного числового формата, за исключением "R", а также любым сочетанием описателей настраиваемого числового формата. Если format имеет значение null или является пустой строкой (""), возвращаемое значение этого экземпляра форматируется с помощью описателя общего числового формата ("G").

.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:

• Дополнительные сведения об описателях числовых форматов, строках стандартного числового формата и строках настраиваемого числового формата.

• Дополнительные сведения о форматировании см. в разделе Типы форматирования.

Возвращаемое значение этого экземпляра отформатировано с использованием NumberFormatInfo для текущего языка и региональных параметров.

См. также раздел

• Parse(String)
• String
• Типы форматирования в .NET
• Строки стандартных числовых форматов
• Строки настраиваемых числовых форматов
• Практическое руководство. Добавление к числу начальных нулей

Исходный код:

Int64.cs

Исходный код:

Int64.cs

Исходный код:

Int64.cs

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string format, IFormatProvider provider);

public string ToString (string? format, IFormatProvider? provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Параметры

Возвращаемое значение

Строковое представление значения данного экземпляра, определяемое параметрами format и provider.

Реализации

Исключения

Примеры

В следующем примере отображается положительное и отрицательное значения с использованием каждого из поддерживаемых описателей стандартного числового формата для трех разных языков и региональных параметров.

// 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", "N0", "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
//
//    N0 format using en-US culture:         1,679           -3,045
//    N0 format using fr-FR culture:         1 679           -3 045
//    N0 format using es-ES culture:         1.679           -3.045
//
//    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 FFFFFFFFFFFFF41B
//    X8 format using fr-FR culture:         0000068F FFFFFFFFFFFFF41B
//    X8 format using es-ES culture:         0000068F FFFFFFFFFFFFF41B

// Define cultures whose formatting conventions are to be used.
let cultures = 
    [| CultureInfo.CreateSpecificCulture "en-US"
       CultureInfo.CreateSpecificCulture "fr-FR"
       CultureInfo.CreateSpecificCulture "es-ES" |]

let positiveNumber = 1679L
let negativeNumber = -3045L
let specifiers = [| "G"; "C"; "D8"; "E2"; "F"; "N"; "N0"; "P"; "X8" |]

for specifier in specifiers do
    for culture in cultures do
        // Display values with "G" format specifier.
        printfn $"{specifier} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"           
    printfn ""

// 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
//
//    N0 format using en-US culture:         1,679           -3,045
//    N0 format using fr-FR culture:         1 679           -3 045
//    N0 format using es-ES culture:         1.679           -3.045
//
//    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 FFFFFFFFFFFFF41B
//    X8 format using fr-FR culture:         0000068F FFFFFFFFFFFFF41B
//    X8 format using es-ES culture:         0000068F FFFFFFFFFFFFF41B

' 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 FFFFFFFFFFFFF41B
'    X8 format using fr-FR culture:         0000068F FFFFFFFFFFFFF41B
'    X8 format using es-ES culture:         0000068F FFFFFFFFFFFFF41B

Комментарии

Метод ToString(String, IFormatProvider) форматирует Int64 значение в указанном формате с помощью NumberFormatInfo объекта указанного языка и региональных параметров. Если вы хотите использовать параметры формата или языка и региональных параметров по умолчанию, используйте другие перегрузки ToString метода следующим образом:

Параметр format может быть стандартной или пользовательской строкой числового формата. Поддерживаются все строки стандартного числового формата, отличные от "R" (или "r"), как и все символы настраиваемого числового формата. Если format имеет значение null или пустую строку (""), возвращаемое значение для этого экземпляра форматируется с помощью описателя общего числового формата ("G").

Параметр provider — это объект, реализующий IFormatProvider интерфейс . Его GetFormat метод возвращает NumberFormatInfo объект , предоставляющий сведения о формате строки, возвращаемой этим методом, с учетом языка и региональных параметров. Объект, реализующий , IFormatProvider может быть любым из следующих:

• Объект CultureInfo , представляющий язык и региональные параметры, правила форматирования которых должны использоваться.

• Объект NumberFormatInfo , содержащий определенные числовые сведения о форматировании для этого значения.

• Пользовательский объект, реализующий IFormatProvider и метод которого GetFormat возвращает NumberFormatInfo объект, предоставляющий сведения о форматировании.

Если provider имеет значение null или NumberFormatInfo объект не может быть получен из provider, возвращаемое значение для этого экземпляра форматируется с параметром NumberFormatInfo для текущего языка и региональных параметров.

.NET предоставляет расширенную поддержку форматирования, которая более подробно описана в следующих разделах:

• Дополнительные сведения об описателях числовых форматов см. в разделах Строки стандартного числового формата и Строки настраиваемого числового формата.

• Дополнительные сведения о форматировании см. в разделе Типы форматирования.

См. также раздел

• Parse(String)
• Типы форматирования в .NET
• Строки стандартных числовых форматов
• Строки настраиваемых числовых форматов
• Практическое руководство. Добавление к числу начальных нулей
• Пример: служебная программа форматирования .NET Core WinForms (C#)
• Пример: служебная программа форматирования .NET Core WinForms (Visual Basic)