Книга: C# 4.0: полное руководство

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

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

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

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

Для получения отформатированного значения достаточно вызвать метод 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() включается обычный текст, как, например, строка "Сумма :    ". Этот текст передается данному методу и становится частью выводимой строки.

Для получения отформатированного строкового представления отдельного значения любого числового типа, которому соответствует встроенная структура, например 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);
    str = v2.ToString("p");
    Console.WriteLine(str);
    str = x.ToString("X");
    Console.WriteLine(str);
    str = x.ToString("D12");
    Console.WriteLine(str);
    str = 189.99.ToString("C");
    Console.WriteLine(str);
  }
}

Оглавление книги