Mono Class Library: System.Text.StringBuilder Overview | Members

System.Text.StringBuilder.AppendFormat Method

Appends the specified string to the current instance, with the format specifications in that string being replaced with the appropriately formatted string value of the specified object.

public StringBuilder AppendFormat (string format, object arg0)

Parameters

format
A string containing zero or more format specifications.
arg0
A object to be formatted.

Returns

The current instance after the operation has occurred.

Exceptions

TypeReason
ArgumentNullExceptionformat is a null reference.
FormatExceptionformat is invalid.

Remarks

This method appends the formatted copy of the specified string to the current instance.

Note: This version of StringBuilder.AppendFormat(string, object) is equivalent to StringBuilder.AppendFormat(string, object)( null , format, new Object[] {arg0} ). For more information on the format specification, see the string class overview.

Example

C# Example

using System;
using System.Text;

public class StringBuilderTest {
  public static void Main() { 
     
      StringBuilder sb = new StringBuilder("The high ");
      Console.WriteLine( sb.AppendFormat("temperature today was {0, 6}.", 88) ); 
  }
}
      

The output is

Example

The high temperature today was     88.
 

Requirements

Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0