Метод AppendFormat

Метод AppendFormat класса StringBuilder дописывает в конец буфера строку, сформированную по шаблону с плейсхолдерами "{0}", "{1}" и так далее. Правила те же, что у string.Format: номер в фигурных скобках указывает аргумент. Буфер меняется на месте, метод возвращает тот же объект.

Синтаксис

sb.AppendFormat(string format, object arg0)
sb.AppendFormat(string format, params object[] args)
sb.AppendFormat(IFormatProvider provider, string format, params object[] args)

Пример

Давайте допишем шаблон с двумя аргументами:

using System;
using System.Text;

class Program
{
	static void Main()
	{
		StringBuilder sb = new StringBuilder("id:");
		sb.AppendFormat("{0}-{1}", "abcde", "12345");
		Console.WriteLine(sb.ToString());
	}
}

Результат выполнения кода:

"id:abcde-12345"

Пример

Давайте вставим число и логическое значение в шаблон:

using System;
using System.Text;

class Program
{
	static void Main()
	{
		StringBuilder sb = new StringBuilder();
		sb.AppendFormat("n={0}; ok={1}", 5, true);
		Console.WriteLine(sb.ToString());
	}
}

Результат выполнения кода:

"n=5; ok=True"

Пример

Давайте допишем форматированный фрагмент к уже имеющемуся тексту:

using System;
using System.Text;

class Program
{
	static void Main()
	{
		StringBuilder sb = new StringBuilder("abcde");
		sb.AppendFormat("[{0}]", "12345");
		Console.WriteLine(sb.ToString());
	}
}

Результат выполнения кода:

"abcde[12345]"

Пример

Давайте построим цепочку из AppendFormat и Append:

using System;
using System.Text;

class Program
{
	static void Main()
	{
		StringBuilder sb = new StringBuilder();
		sb.AppendFormat("{0}", "abc")
			.Append("de");
		Console.WriteLine(sb.ToString());
	}
}

Результат выполнения кода:

"abcde"

Смотрите также

метод Append,
который дописывает значение без шаблона
метод AppendJoin,
который склеивает элементы через разделитель
Интерполяция строк,
который вставляет значения в строковый литерал
метод ToString,
который возвращает текст из буфера