C# 4.0: полное руководство - Герберт Шилдт

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

Применение метода String. Format() для форматирования значений

Для получения отформатированного значения достаточно вызвать метод Format(), определенный в классе String, в соответствующей его форме. Все формы этого метода перечислены в табл. 22.5. Метод Format() аналогичен методу WriteLine(), за исключением того, что он возвращает отформатированную строку, а не выводит ее на консоль.

Метод - Описание

public static string Format(string format, object arg0) - Форматирует объект arg0 в соответствии с первой командой форматирования, которая содержится в строке format. Возвращает копию строки format, в которой команда форматирования заменена отформатированными данными

public static string Format(string format, object arg0, object arg1) - Форматирует объект arg0 в соответствии с первой командой форматирования, содержащейся в строке format, а объект arg1 — в соответствии со второй командой. Возвращает копию строки format, в которой команды форматирования заменены отформатированными данными

public static string Format(string format, object arg0, object arg1, object arg2) - Форматирует объекты arg0, arg1 и агд2 по соответствующим командам форматирования, содержащимся в строке format. Возвращает копию строки format, в которой команды форматирования заменены отформатированными данными

public static string Format (string format, params object[] args) - Форматирует значения, передаваемые в массиве args, в соответствии с командами форматирования, содержащимися в строке format. Возвращает копию строки format, в которой команды форматирования заменены отформатированными данными

public static string Format (IFormatProvider provider, string format, params object[] args) - Форматирует значения, передаваемые в массиве args, в соответствии с командами форматирования, содержащимися в строке format, используя поставщик формата provider. Возвращает копию строки format, в которой команды форматирования заменены отформатированными данными

Ниже приведен вариант предыдущего примера программы форматирования, измененный с целью продемонстрировать применение метода String.Format(). Этот вариант дает такой же результат, как и предыдущий.

// Использовать метод String.Format() для форматирования значений,

using System;

class FormatDemo {

  static void Main() {

    double v = 17688.65849;

    double v2 = 0.15;

    int x = 21;

    string str = String.Format("{0:F2}", v);

    Console.WriteLine(str) ;

    str = String.Format("{0:N5}", v);

    Console.WriteLine(str);

    str = String.Format("{0:e}", v);

    Console.WriteLine(str);

    str = String.Format("{0:r}", v);

    Console.WriteLine(str);

    str = String.Format("{0:p}", v2);

    Console.WriteLine(str);

    str = String.Format("{0:X}", x);

    Console.WriteLine(str);

    str = String.Format("{0:D12}", x);

    Console.WriteLine(str);

    str = String.Format("{0:C}", 189.99);

    Console.WriteLine (str);

  }

}

Аналогично методу WriteLine(), метод String.Format() позволяет встраивать в свой вызов обычный текст вместе со спецификаторами формата, причем в вызове данного метода может быть указано несколько спецификаторов формата и значений. В качестве примера рассмотрим еще одну программу, отображающую текущую сумму и произведение чисел от 1 до 10.

// Еще один пример применения метода Format().

using System;

class FormatDemo2 {

  static void Main() {

    int i;

    int sum = 0;

    int prod = 1;

    string str;

    /* Отобразить текущую сумму и произведение чисел от 1 до 10. */

    for(i=1; i <= 10; i++) {

      sum += i;

      prod *= i;

      str = String.Format("Сумма:{0,3:D} Произведение:{1,8:D}",

               sum, prod);

      Console.WriteLine(str);

    }

  }

}

Ниже приведен результат выполнения этой программы

Сумма:    1    Произведение:       1

Сумма:    3    Произведение:       2

Сумма:    6    Произведение:       6

Сумма:   10    Произведение:      24

Сумма:   15    Произведение:     120

Сумма:   21    Произведение:     720

Сумма:   28    Произведение:    5040

Сумма:   36    Произведение:   40320

Сумма:   45    Произведение:  362880

Сумма:   55    Произведение: 3628800

Обратите особое внимание в данной программе на следующий оператор.

str = String.Format("Сумма:{0,3:D} Произведение:{1,8:D}", sum, prod);

В этом операторе содержится вызов метода Format() с двумя спецификаторами формата: одним — для суммы (в переменной sum), а другим — для произведения (в переменной prod). Обратите также внимание на то, что номера аргументов указываются таким же образом, как и в вызове метода WriteLine(), и что в вызов метода Format() включается обычный текст, как, например, строка "Сумма :    ". Этот текст передается данному методу и становится частью выводимой строки.

Применение метода ToString() для форматирования данных

Для получения отформатированного строкового представления отдельного значения любого числового типа, которому соответствует встроенная структура, например Int32 или Double, можно воспользоваться методом ToString(). Этой цели служит приведенная ниже форма метода ToString().

public string ToString("форматирующая строка")

В этой форме метод ToString() возвращает строковое представление вызывающего объекта в том формате, который определяет спецификатор "форматирующая строка", передаваемый данному методу. Например, в следующей строке кода формируется строковое представление значения 188.99 в формате денежной единицы с помощью спецификатора формата С.

string str = 189.99.ToString("С");

Обратите внимание на то, что спецификатор формата передается методу ToString() непосредственно. В отличие от встроенных команд форматирования, используемых в вызовах методов WriteLine() и Format(), где для этой цели дополнительно указываются номер аргумента и ширина поля, в вызове метода ToString() достаточно указать только спецификатор формата.

Ниже приведен вариант примера предыдущей программы форматирования, измененный с целью продемонстрировать применение метода ToString() для получения отформатированных строк. Этот вариант дает такой же результат, как и предыдущий.

// Использовать метод ToString() для форматирования значений.

using System;

class ToStringDemo {

  static void Main() {

    double v = 17688.65849;

    double v2 = 0.15;

    int x = 21;

    string str = v.ToString("F2");

    Console.WriteLine(str);

    str = v.ToString("N5");

    Console.WriteLine(str);

    str = v.ToString("e");

    Console.WriteLine(str);

    str = v.ToString("r");

    Console.WriteLine(str);