Decimal.ToString Метод

Ссылка

Определение

Пространство имен:: System

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Преобразует значение данного экземпляра в эквивалентное ему представление типа String.

Перегрузки

ToString()	Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.
ToString(IFormatProvider)	Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанных сведений об особенностях форматирования для данного языка и региональных параметров.
ToString(String)	Преобразует числовое значение данного экземпляра в эквивалентное строковое представление с использованием указанного формата.
ToString(String, IFormatProvider)	Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление с использованием указанного формата и сведений об особенностях форматирования для данного языка и региональных параметров.

ToString()

Исходный код:: Decimal.cs

Исходный код:: Decimal.cs

Исходный код:: Decimal.cs

Преобразует числовое значение данного экземпляра в эквивалентное ему строковое представление.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

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

String

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

Примеры

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

decimal value = -16325.62m;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325.62
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325.62
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.62)
Console.WriteLine(value.ToString("F"));         // Displays -16325.62

let value = -16325.62m
// Display value using default ToString method.
printfn $"{value.ToString()}"            // Displays -16325.62
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}"""      // Displays -16325.62
printfn $"""{value.ToString "C"}"""      // Displays ($16,325.62)
printfn $"""{value.ToString "F"}"""      // Displays -16325.62

Dim value As Decimal = -16325.62d
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325.62
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325.62
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.62)
Console.WriteLine(value.ToString("F"))         ' Displays -16325.62

В следующем примере отображается сумма денег на счете.

   public ref class PiggyBank
   {
   public:
      void AddPenny()
      {
         MyFortune = Decimal::Add( MyFortune, (Decimal).01 );
      }

      virtual System::String^ ToString() override
      {
         return MyFortune.ToString("C")+" in piggy bank";
      }

   protected:
      Decimal MyFortune;
   };
}

class PiggyBank {
    public void AddPenny() {
        MyFortune = Decimal.Add(MyFortune, .01m);
    }

    public override string ToString() {
        return MyFortune.ToString("C")+" in piggy bank";
    }

    protected decimal MyFortune;
}

type PiggyBank() =
    let mutable myFortune = 0m

    member _.AddPenny() =
        myFortune <- Decimal.Add(myFortune, 0.01m)

    override _.ToString() =
        $"{myFortune:C} in piggy bank"

Class PiggyBank

    Public Sub AddPenny()
        MyFortune = [Decimal].Add(MyFortune, 0.01D)
    End Sub

    Public Overrides Function ToString() As String
        Return MyFortune.ToString("C") + " in piggy bank"
    End Function

    Protected MyFortune As Decimal
End Class

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

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат по умолчанию ("G")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Язык и региональные параметры по умолчанию (текущий)	ToString(String)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

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

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

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

Применяется к

ToString(IFormatProvider)

Исходный код:: Decimal.cs

Исходный код:: Decimal.cs

Исходный код:: Decimal.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: IFormatProvider

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

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

String

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

Реализации

ToString(IFormatProvider)

Примеры

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

decimal value = -16325.62m;
// 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:
//       -16325.62
//       -16325.62
//       -16325,62

let value = -16325.62m
// 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:
//       -16325.62
//       -16325.62
//       -16325,62

Dim value As Decimal = -16325.62d
' 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:
'       -16325.62
'       -16325.62
'       -16325,62

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

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат по умолчанию ("G")	Язык и региональные параметры по умолчанию (текущий)	ToString()
Определенный формат	Язык и региональные параметры по умолчанию (текущий)	ToString(String)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

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

Параметр provider является реализацией, IFormatProvider метод которой IFormatProvider.GetFormat возвращает NumberFormatInfo объект . Как правило, provider является NumberFormatInfo объектом или CultureInfo объектом . Параметр provider предоставляет сведения, относящиеся к языку и региональным параметрам, которые используются при форматировании. Если значение параметра provider равно null, используются текущий язык и региональные параметры потока.

Чтобы преобразовать значение в Decimal строковое представление, используя указанные язык и региональные параметры и определенную строку формата, вызовите Decimal.ToString(String, IFormatProvider) метод .

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

Применяется к

ToString(String)

Исходный код:: Decimal.cs

Исходный код:: Decimal.cs

Исходный код:: Decimal.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: String

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

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

String

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

Исключения

FormatException

format недопустим.

Примеры

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

decimal value = 16325.62m;
string specifier;

// Use standard numeric format specifiers.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: 16325.62
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: $16,325.62
specifier = "E04";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E04: 1.6326E+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: 16325.62
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: 16,325.62
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier));
// Displays:    P: 163.26 %

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

let value = 16325.62m

// Use standard numeric format specifiers.
let specifier = "G"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    G: 16325.62
let specifier = "C"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    C: $16,325.62
let specifier = "E04"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    E04: 1.6326E+004
let specifier = "F"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    F: 16325.62
let specifier = "N"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    N: 16,325.62
let specifier = "P"
printfn $"{specifier}: {(value / 10000m).ToString specifier}"
// Displays:    P: 163.26 %

// Use custom numeric format specifiers.
let specifier = "0,0.000"
printfn $"{specifier}: {value.ToString specifier}"
// Displays:    0,0.000: 16,325.620
let specifier = "#,#.00#(#,#.00#)"
printfn $"{specifier}: {(value * -1m).ToString specifier}"
// Displays:    #,#.00#(#,#.00#): (16,325.62)

Dim value As Decimal = 16325.62d
Dim specifier As String

' Use standard numeric format specifiers.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: 16325.62
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: $16,325.62
specifier = "E04"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E04: 1.6326E+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: 16325.62
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: 16,325.62
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier))
' Displays:    P: 163.26 %

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

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

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат по умолчанию ("G")	Язык и региональные параметры по умолчанию (текущий)	ToString()
Формат по умолчанию ("G")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Определенный язык и региональные параметры	ToString(String, IFormatProvider)

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

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

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

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

Применяется к

ToString(String, IFormatProvider)

Исходный код:: Decimal.cs

Исходный код:: Decimal.cs

Исходный код:: Decimal.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: String

Строка числового формата.

provider: IFormatProvider

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

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

String

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

Реализации

ToString(String, IFormatProvider)

Исключения

FormatException

format недопустим.

Примеры

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

decimal value = 16325.62m;
string specifier;
CultureInfo culture;

// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays:    16325.62

specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    £16,325.62

specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004
 culture = CultureInfo.CreateSpecificCulture("en-NZ");
 Console.WriteLine(value.ToString(specifier, culture));
// Displays:    1.6326E+004

specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.62

specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16 325,62

specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.256 %

let value = 16325.62m

// Use standard numeric format specifiers.
let specifier = "G"
let culture = CultureInfo.CreateSpecificCulture "eu-ES"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
// Displays:    16325.62

let specifier = "C"
let culture = CultureInfo.CreateSpecificCulture "en-US"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    $16,325.62
let culture = CultureInfo.CreateSpecificCulture "en-GB"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    £16,325.62

let specifier = "E04"
let culture = CultureInfo.CreateSpecificCulture "sv-SE"
Console.WriteLine(value.ToString(specifier, culture))
// Displays: 1,6326E+004
let culture = CultureInfo.CreateSpecificCulture "en-NZ"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    1.6326E+004

let specifier = "F"
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325,62
let culture = CultureInfo.CreateSpecificCulture "en-CA"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16325.62

let specifier = "N"
let culture = CultureInfo.CreateSpecificCulture "es-ES"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16.325,62
let culture = CultureInfo.CreateSpecificCulture "fr-CA"
Console.WriteLine(value.ToString(specifier, culture))
// Displays:    16 325,62

let specifier = "P"
let culture = CultureInfo.InvariantCulture
printfn $"{(value / 10000m).ToString(specifier, culture)}"
// Displays:    163.26 %
let culture = CultureInfo.CreateSpecificCulture "ar-EG"
printfn $"{(value / 10000m).ToString(specifier, culture)}"
// Displays:    163.256 %

Dim value As Decimal = 16325.62d
Dim specifier As String
Dim culture As CultureInfo

' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62

specifier = "C"
culture = CultureInfo.CreateSpecificCulture("en-US")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    £16,325.62

specifier = "E04"
culture = CultureInfo.CreateSpecificCulture("sv-SE")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ")
 Console.WriteLine(value.ToString(specifier, culture))
' Displays:    1.6326E+004   

specifier = "F"
culture = CultureInfo.CreateSpecificCulture("fr-FR")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.62

specifier = "N"
culture = CultureInfo.CreateSpecificCulture("es-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16 325,62

specifier = "P"
culture = CultureInfo.InvariantCulture
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG")
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.256 %

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

Использование формата	Для языка и региональных параметров	Использование перегрузки
Формат по умолчанию ("G")	Язык и региональные параметры по умолчанию (текущий)	ToString()
Формат по умолчанию ("G")	Определенный язык и региональные параметры	ToString(IFormatProvider)
Определенный формат	Язык и региональные параметры по умолчанию (текущий)	ToString(String)

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

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

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

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

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

Применяется к

Поделиться через

Decimal.ToString Метод

Определение

Перегрузки

ToString()

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

Примеры

Комментарии

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

Применяется к

ToString(IFormatProvider)

Параметры

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

Реализации

Примеры

Комментарии

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

Применяется к

ToString(String)

Параметры

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

Исключения

Примеры

Комментарии

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

Применяется к

ToString(String, IFormatProvider)

Параметры

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

Реализации

Исключения

Примеры

Комментарии

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

Применяется к

Дополнительные ресурсы