Mono Documentation

Appends the specified string to the current instance, with the format specifications in that string being replaced with the appropriately formatted string values of the elements in the specified array. [Edit]

public StringBuilder AppendFormat (string format, params object[] args)

Parameters

format
A string containing zero or more format specifications. [Edit]
args
A object array to be formatted. [Edit]

Returns

The current instance after operation has occurred. [Edit]

Exceptions

Type Reason
ArgumentNullException format is a null reference. [Edit]
FormatException format is invalid. [Edit]

Type	Reason
ArgumentNullException	format is a null reference. [Edit]
FormatException	format is invalid. [Edit]

Remarks

This method appends the formatted copy of the specified string to the current instance. If an object referenced in the format string is null , an empty string is used in its place.
Note: This version of StringBuilder.AppendFormat(string, object) is equivalent to StringBuilder.AppendFormat(string, object)( null , format, args ). For more information on the format specification see the string class overview.
[Edit]

Example

C# Example

using System;
using System.Text;

public class StringBuilderTest {
  public static void Main() {

     string [] strings = {"very", "very", null, "high"};

     StringBuilder sb = new StringBuilder("The high ");
     Console.WriteLine( sb.AppendFormat("temperature today was {0}, {1} {2}{3}.", strings) ); 
  }
}

The output is

The high temperature today was very, very high.

Requirements